引言

覺得自己有必要要學學Markdown了，但同時擔心光看自己記不住，同時想作為工具書日后忘記用于回顧。
本文刪去了Markdown語法說明中的一些如md與html之間的轉義等繁瑣說明，教之更為精簡，更專注于Markdown本身語法。

區塊元素

標題

在行首插入 1 到 6 個 # ，對應到標題 1 到 6 階，例如：

# 這是 H1
## 這是 H2
### 這是 H3
#### 這是H4
#####這是H5
###### 這是 H6

實際效果如下：

這是 H1

這是 H2

這是 H3

這是H4

這是H5

這是 H6

區塊引用

在最前面加上 > 即可

> 這是一個區塊引用
只在第一行加 >

效果等同于：
> 這是一個區塊引用
> 每行都加 >

> 這是一個區塊引用
> > 嵌套使用>

> #### 在引用中使用標題。
> 
> 1.   在引用中使用列表項。

> 空四個格子或一個制表符引用代碼：
> 
>     //test
>     public class Main{
>
>     }

實際效果：

這是一個區塊引用

這是一個區塊引用
每行都加 >

這是一個區塊引用

嵌套使用>

在引用中使用標題。

1. 在引用中使用列表項。

空四個格子或一個制表符引用代碼：

//test
public class Main{

}

列表

無序列表使用星號、加號或減號標記（三者互相等同）：

* unordered list 1
+ unordered list 2
- unordered list 3

在無需列表項內放入引用，需要縮進4格：
1.列表項
     > 引用內容

在無需列表項內放入代碼塊，需要空一行縮進8格：
1.列表項

         代碼塊

效果如下：

• unordered list *
• unordered list *

• unordered list -
• unordered list -

• unordered list +
• unordered list +

• 無序列表項

  引用內容

• 無序列表項

    代碼塊
  

有序列表使用數字接一個英文句號：

1. 表項1
2. 表項2
3. 表項3

效果如下：

1. 表項1
2. 表項2
3. 表項3

（注意：有序列表不支持加入引用和代碼塊）

代碼區塊

在Markdown中建立代碼區塊，只需要空一行并縮進4個空格或一個制表符即可：

如下：
代碼區塊的前一行文字：
  
    (代碼內容)

效果如下：

代碼區塊前一行文字：

(代碼內容)

分割線

用三個以上的星號、減號、底線來建立分割線，行內不能有其他東西：

* * *
***
*****
- - -
---------------------------------------

效果如下：

區段元素

鏈接

Markdown 支持兩種形式的鏈接語法： 行內式和參考式兩種形式。

行內式鏈接語法

在方塊括號（顯示文本）后面緊接著圓括號并插入網址鏈接即可，如果你還想要加上鏈接的標題，只要在網址后面，用雙引號把文字包起來即可，例如：

這是一個行內式[鏈接](http://example.com/ "標題") 。

這個行內式[鏈接](http://example.net/) 沒有標題屬性。

連接到[本地](/local/ "本地資源")資源。

效果如下：

這是一個行內式鏈接 .
這個行內式鏈接 沒有標題屬性.
連接到本地資源。

參考式鏈接語法

參考式的鏈接是在鏈接文字的括號后面再接上另一個方括號，第二個方括號里填入的是用以唯一標識鏈接的標記id，例如：

這是一個參考式[鏈接][link1]。
......

然后在這個markdown文件的任意處定義上面的標記：
    [link1]: http://example.com/ "參考式鏈接標題"
也可以寫成這樣：
    [link1]: <http://example.com/> "參考式鏈接標題"

標簽可以由字母、數字、空白和標點符號組成，但是并不區分大小寫，因此下面兩個鏈接是一樣的：
    [link text][a]
    [link text][A]

隱式鏈接標記，形如[link][]，第二個方括號空著，可以省略指定鏈接ID，這種情形下，ID會視為等同于鏈接文字。

效果如下：

這是一個參考式鏈接。
隱式link2（雖然直觀上看不出來）。

強調

Markdown 使用星號（*）和底線（_）作為標記強調字詞的符號。
被 * 或 _ 包圍的字詞會被轉成斜體，用兩個 * 或 _ 包起來的話，則會被轉成粗體，例如：

*單星號強調（斜體）*

_單下劃線強調（斜體）_

**雙星號強調（粗體）**

__雙下劃線強調（粗體）__

***三符號強調（斜體+粗體）***

插在**文字**中間的強調

反斜杠來顯示 \*號

效果如下：

單星號強調（斜體）
單下劃線強調（斜體）
雙星號強調（粗體）
雙下劃線強調（粗體）
三符號強調（斜體+粗體）
插在文字中間的強調
反斜杠來顯示 *號

行內代碼

標記一小段行內代碼，用反引號將代碼包起來，例如：

`code`寫的非常的爛。

``用兩個反引號來顯示代碼中的反引號（`）``

用兩個\`\`來包圍代碼并空格分開來顯示代碼開頭和結尾的反引號: `` `foo` ``

效果如下：

printp("是printf不是printp");這里寫錯了。
用兩個反引號來顯示代碼中的反引號（`）
用兩個``來包圍代碼并空格分開來顯示代碼開頭和結尾的反引號: `foo`

圖片

Markdown 使用一種和鏈接很相似的語法來標記圖片，同樣也允許兩種樣式： 行內式和參考式。
其實圖片與鏈接的語法類似，只是多了一個感嘆號（！）而已，并沒有看上去那么復雜。

行內式圖片

行內式的圖片語法是使用一個感嘆號接一對方括號接一對圓括號，圓括號里面放入放上圖片的網址，后面可以用引號包住選擇性的標題文字，例如：

![](/path/to/img.jpg "可選標題")

效果如下：

網絡圖片

參考式圖片

參考式的圖片語法是使用一個感嘆號接一對方括號，再接上一對方括號，例如：

![可選文字][id]
......
同樣的在md文件任意處定義id
[id]: url/to/image  "可選標題"

效果如下：

網絡圖片

其他

自動鏈接

只要是用尖括號包起來， Markdown 就會自動把它轉成鏈接。一般網址的鏈接文字就和鏈接地址一樣，例如：

<http://example.com/>
<address@example.com>

效果如下：

http://example.com/
address@example.com

反斜杠

可以利用反斜杠來插入一些在語法中有其它意義的符號，例如：

\*
\-
\+

效果如下：

*
-
+

表格

123
345
見例：

//注意第二行的冒號（：）
//結合效果展示可以看出：
//默認不加冒號為文字靠左，兩邊都加冒號為文字居中，加在右邊為文字靠右

|Attribute1|Attribute2|Attribute3|Attribute4|
|----------|:----------|--------:|:--------:|
|mem1|mem1|mem1|mem1|
|mem2|mem2|mem2|mem2|

效果如下：

靠左（默認）	靠左	靠右	居中
mem1	mem1	mem1	mem1
mem2	mem2	mem2	mem2