Markdown 列表

2019-08-14 12:09 更新

Markdown 支持有序列表和無序列表。

無序列表使用星號、加號或是減號作為列表標(biāo)記:

*   Red
*   Green
*   Blue

等同于:

+   Red
+   Green
+   Blue

也等同于:

-   Red
-   Green
-   Blue

有序列表則使用數(shù)字接著一個英文句點:

1.  Bird
2.  McHale
3.  Parish

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

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

如果你的列表標(biāo)記寫成:

1.  Bird
1.  McHale
1.  Parish

或甚至是:

3. Bird
1. McHale
8. Parish

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

如果你使用懶惰的寫法,建議第一個項目最好還是從 1. 開始,因為 Markdown 未來可能會支持有序列表的 start 屬性。

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

要讓列表看起來更漂亮,你可以把內(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.

如果列表項目間用空行分開,在輸出 HTML 時 Markdown 就會將項目內(nèi)容用 <p> 標(biāo)簽包起來,舉例來說:

*   Bird
*   Magic

會被轉(zhuǎn)換為:

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

但是這個:

*   Bird

*   Magic

會被轉(zhuǎn)換為:

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

列表項目可以包含多個段落,每個項目下的段落都必須縮進(jìn) 4 個空格或是 1 個制表符:

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),看起來會看好很多,當(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.

如果要在列表項目內(nèi)放進(jìn)引用,那 > 就需要縮進(jìn):

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

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

*   一列表項包含一個列表區(qū)塊:

        <代碼寫在這>

當(dāng)然,項目列表很可能會不小心產(chǎn)生,像是下面這樣的寫法:

1986. What a great season.

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

1986\. What a great season.


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號