Markdown 列表

Markdown 支持有序列表和無(wú)序列表。

無(wú)序列表使用星號(hào)、加號(hào)或是減號(hào)作為列表標(biāo)記：

*   Red
*   Green
*   Blue

等同于：

+   Red
+   Green
+   Blue

也等同于：

-   Red
-   Green
-   Blue

有序列表則使用數(shù)字接著一個(gè)英文句點(diǎn)：

1.  Bird
2.  McHale
3.  Parish

很重要的一點(diǎn)是，你在列表標(biāo)記上使用的數(shù)字并不會(huì)影響輸出的 HTML 結(jié)果，上面的列表所產(chǎn)生的 HTML 標(biāo)記為：

<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>

如果你的列表標(biāo)記寫(xiě)成：

1.  Bird
1.  McHale
1.  Parish

或甚至是：

3. Bird
1. McHale
8. Parish

你都會(huì)得到完全相同的 HTML 輸出。重點(diǎn)在于，你可以讓 Markdown 文件的列表數(shù)字和輸出的結(jié)果相同，或是你懶一點(diǎn)，你可以完全不用在意數(shù)字的正確性。

如果你使用懶惰的寫(xiě)法，建議第一個(gè)項(xiàng)目最好還是從 1. 開(kāi)始，因?yàn)?Markdown 未來(lái)可能會(huì)支持有序列表的 start 屬性。

列表項(xiàng)目標(biāo)記通常是放在最左邊，但是其實(shí)也可以縮進(jìn)，最多 3 個(gè)空格，項(xiàng)目標(biāo)記后面則一定要接著至少一個(gè)空格或制表符。

要讓列表看起來(lái)更漂亮，你可以把內(nèi)容用固定的縮進(jìn)整理好：

*   Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
    Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
    viverra nec, fringilla in, laoreet vitae, risus.
*   Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
    Suspendisse id sem consectetuer libero luctus adipiscing.

但是如果你懶，那也行：

*   Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.
*   Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.

如果列表項(xiàng)目間用空行分開(kāi)，在輸出 HTML 時(shí) Markdown 就會(huì)將項(xiàng)目?jī)?nèi)容用 <p> 標(biāo)簽包起來(lái)，舉例來(lái)說(shuō)：

*   Bird
*   Magic

會(huì)被轉(zhuǎn)換為：

<ul>
<li>Bird</li>
<li>Magic</li>
</ul>

但是這個(gè)：

*   Bird

*   Magic

會(huì)被轉(zhuǎn)換為：

<ul>
<li><p>Bird</p></li>
<li><p>Magic</p></li>
</ul>

列表項(xiàng)目可以包含多個(gè)段落，每個(gè)項(xiàng)目下的段落都必須縮進(jìn) 4 個(gè)空格或是 1 個(gè)制表符：

1.  This is a list item with two paragraphs. Lorem ipsum dolor
    sit amet, consectetuer adipiscing elit. Aliquam hendrerit
    mi posuere lectus.

    Vestibulum enim wisi, viverra nec, fringilla in, laoreet
    vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
    sit amet velit.

2.  Suspendisse id sem consectetuer libero luctus adipiscing.

如果你每行都有縮進(jìn)，看起來(lái)會(huì)看好很多，當(dāng)然，再次地，如果你很懶惰，Markdown 也允許：

*   This is a list item with two paragraphs.

    This is the second paragraph in the list item. You're
only required to indent the first line. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit.

*   Another item in the same list.

如果要在列表項(xiàng)目?jī)?nèi)放進(jìn)引用，那 > 就需要縮進(jìn)：

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

如果要放代碼區(qū)塊的話(huà)，該區(qū)塊就需要縮進(jìn)兩次，也就是 8 個(gè)空格或是 2 個(gè)制表符：

*   一列表項(xiàng)包含一個(gè)列表區(qū)塊：

        <代碼寫(xiě)在這>

當(dāng)然，項(xiàng)目列表很可能會(huì)不小心產(chǎn)生，像是下面這樣的寫(xiě)法：

1986. What a great season.

換句話(huà)說(shuō)，也就是在行首出現(xiàn)數(shù)字-句點(diǎn)-空白，要避免這樣的狀況，你可以在句點(diǎn)前面加上反斜杠。

1986\. What a great season.