- 在markdown語法中, 用*或+或-在行首表示無序列表。在這些符號之后應該空一格然后輸入內容。
例如 + 無序列表 * 無序列表 - 無序列表
會被markdown語法渲染為
- 無序列表
-
列表嵌套
- 如果希望一個沒有加列表點的段落和一個列表項的內容顯示對齊。需要把非列表段落行首打一個Tab(或者四個Space,以后使用Tab的地方類似,不再強調)。
* 我們需要……
還沒說完……
以及……PS:……
顯示為
-
我們需要……
還沒說完……
以及……
PS:……
使用該功能的時候特別注意不要多敲Tab或Space。一行行首存在Tab(或行首Space大於等於4個),且不是多層列表嵌套或列表對齊,就會識別為代碼段落。
- 如果希望一個列表作為另一個列表的子項目同樣可以使用Tab實現。
* 做一些事 * 做另一些事 + 第一步 + 第二步 * 另外做……
顯示為
- 做一些事
- 做另一些事
- 第一步
- 第二步
- 另外做……
源代碼中使用什么符號和渲染的結果沒有直接關系。把上邊的
+
換成*
顯示效果也一樣。但是這樣寫可以增強源代碼結構性。實際使用中,盡量不要同級使用不同符號。同理對於不同級別盡量使用不同符號。如果列表、代碼段落、引用相互嵌套的時候,一定注意數清楚每行應該用幾個Tab。
-
有序列表:用數字加‘.’在行首表示有序列表。在‘.’后應該空一格再寫內容。
有如下3點: 1. 無序 2. 有序 3. 縮進
顯示為
有如下3點:
- 無序
- 有序
- 縮進
也可以使用ASCII中的
)
代替.
符號,但是和無序列表一樣盡量不要在同一級別混用兩種樣式。有序列表的對齊和分級與無序列表類似。但是額外注意有序列表序號不要寫亂,雖然有時候渲染會自動糾正序號。
-
如果一行被標記為列表項。那么不論這一行之前有沒有空行,本行和上一行都被視為兩個段落。但是如果后邊沒有空行且下一行不是列表項,則本行仍可與后一行屬於同一段落。
aaa * 本行后邊沒有雙空格 bbb
aaa
- 本行后邊有雙空格
bbb
顯示為
aaa
- 本行后邊沒有雙空格
bbb
aaa
- 本行后邊有雙空格
bbb
- 本行后邊有雙空格
-
關於縮進的“容忍度”
-
行首如果有大於等於4個Space,本行被視為代碼段落。代碼段落選然后會原樣輸出所有符號。
-
標題標記,列表標記符號之后除了必須的那一個Space,如果還有大於等於4分割Space,那么原本標記的格式會失效,認為是后接了一個代碼段落。(后邊的引用塊也有類似情況。)
-