hugo發表文章


Hugo的文章基本上是以md檔案儲存的，這邊紀錄一下md能使用的語法。

markdown是一種標記語言的格式，他可以用容易閱讀的方式來進行文件編輯，然後再利用其他程式(EX:Hugo)把檔案轉換成html文件來使用，使用這種文件撰寫可以同時保留一個容易閱讀的文件與分享出去的html文件。

原則上除了換行以外多數的MD編輯器都有功能案就可以使用，如果不想記憶這些寫法的話，只要記得行尾兩個空白可以換行，一行以上的換行可以換段落就好，剩下的使用編輯器進行補助。

行內HTML

不在md標籤內的部分都可以直接使用html
區塊元素table、div、pre等標籤需要在前方空一行
而且無法在內部使用md語法

<table>
    <tr>
        <th>測試</th>
        <th>測試2</th>
    </tr>
    <tr>
        <td>測試</td>
        <td>測試2</td>
    </tr>
</table>

其他標籤則不受這限制並且可以混用md語法

特殊字元轉換

在html中&不會被自動轉換
而一般md語法則會被轉換成&amp;
直接轉換的例子 &copy;->©

段落和換行

一個以上的空行會切分出不同的段落
換行則是在行尾加入兩個空白

標題

有兩種方式，一種是用底線

標題
====== 第二階標題
-—–

另一種形式則是在前方加#，對應html的h1~h6

# 標題
## 標題二 最多6個#

區塊引言

在前方加入>即可

> 引言區塊

需要多層的話只要在區塊內再使用>
並且在區塊內可以使用其他md語法

清單

無序號清單使用*或+或-做開頭

* 清單
* 清單
+ tt
+ tt
- tt
- tt

有序號清單使用數字加.

1. 清單
2. 清單
8. 數字不照順序也可以

清單如果要包含多個段落，段落的開頭都必須有四個空白或一個tab

1.  test
    
    ttte

放入引言也是需要四個空白

1.  test

    > test1111

放入程式碼區塊則需要八個空白或兩個tab

*   code  
        <code goes here>
        int test
        </code>

分隔線

在一行中用三個以上的*或-或_可以建立分隔線

***
---
___

連結

有兩種標記法，第一種是用方括號[]後面用()插入連結即可

[連結文字](http://網址 "網址title")  
[相對路徑](/網址 "網址title")

另一種方式是是用方括號後再用一個方括號填入連結標籤

[連結文字][linkaa]

然後在文件任意地點定義這個標籤，定義前記得空一行
定義方式為方括弧[]後接冒號:，接著空一格以上輸入網址，在空一格輸入標籤
這邊要注意定義不區分大小寫

[linkaa]:   http://網址.com.tw "test"

簡單的連結也可以直接用<>包起來
只要用角括號包起來就會自動轉換成連結

<http://連結>  
<email@ex.test>

強調

用*或_標記強調的文字，單個會變轉成<em>標籤，兩個則會轉為<strong>

*test*  
**test**  
_test_  
__test__

程式碼區塊

程式碼區塊只要空行後四個空格或一個tab即可

    code block
        codeline2

程式碼區塊會一直到沒有縮排為止
也可以使用三個`來包住程式碼

```語言的英文(EX:PHP)
程式碼
```

程式碼

如果要標記一小段程式碼可以用反引號`包起來

` int a`

如果程式碼中需要出現反引號的話可以使用兩個反引號作為開頭與結束

`` code need use `  ``

圖片

圖片有行內和參考兩種寫法
先一個驚嘆號!大括號[文字]括號(網址)
目前為止還沒有辦法指定圖片的寬高，如果需要其他設定需要直接使用html

![圖片文字](/path/jpg "title文字")  
用參考的方式和超連結一樣
![圖片文字](參考標籤)

跳脫字元

在特殊字元前面加上反斜線\就可以顯示為原本的符號

Tags : Hugo