Markdown 列表

1. 前言

關于列表，Markdown 作者給出了如下定義：

中文解釋：Markdown 支持有序和無序兩種列表，無序列表使用 「星號 "*"」、「加號 "+"」、「減號 "-"」表示，有序列表使用數(shù)字定義，如: 1. xxx 2.xxx 3.xxx 等。

原文出處：daringfireball.net。

列表是一種將同類內(nèi)容進行結(jié)構(gòu)化編排輸出的顯示方式。列表分為有序列表和無序列表，單級列表和多級列表。

環(huán)境說明：
考慮到 Markdown 工具之間的不兼容，有的內(nèi)容直接從頁面復制粘貼到本地不會正常顯示，大家學習時自己動手寫是肯定沒問題的。本節(jié)所有實例代碼及演示效果均使用 Typora 工具完成。

2. 語法詳解

2.1 無序列表

在 Markdown 文件中，我們可以通過 *、+、-，三種方式定義無序列表，這三種方式的發(fā)布后的效果一樣，都會被轉(zhuǎn)換成：

<ul>
<li></li>
</ul>

實例 1：

### 無序列表

使用星號生成無序列表

* 項目1
* 項目2
* 項目3

使用加號生成無序列表

+ 項目1
+ 項目2
+ 項目3

使用減號生成無序列表

- 項目1
- 項目2
- 項目3

渲染結(jié)果如下：

2.2 有序列表

在 Markdown 文件中，通過「數(shù)字 + . 」的形式定義有序列表，有序列表在發(fā)布后會被轉(zhuǎn)化為：

<ol>
  <li></li>
</ol>

實例 2：

### 有序列表

使用數(shù)字實現(xiàn)有序列表

1. 項目1
2. 項目2
3. 項目3

源碼中的數(shù)字與渲染后的數(shù)字并不一一對應，但可以決定列表的開始序號

例如，讓 Markdown 渲染器自動安排序號：

0. 項目1
0. 項目2
0. 項目3

讓有序列表以 “2” 開頭：

2. 項目1
1. 項目2
0. 項目3

其渲染結(jié)果如下：

2.3 列表的嵌套

Markdown 文件的列表支持多層嵌套，即每個列表里面允許增加下級列表，而且這個層級并沒有限制。

實例 3：

無序列表嵌套無序列表

### 無序列表的嵌套

無序列表可以通過縮進實現(xiàn)嵌套

* 項目 1
    * 項目 1-1
* 項目2
    * 項目 2-1
    * 項目 2-2
* 項目3

無序列表的嵌套是沒有層數(shù)限制的

* 第一層 1
    * 第二層 1
      * 第三層 1
        * 第四層 1
          * 第五層 1
      * 第三層 2
    * 第二層 2

其渲染結(jié)果如下：

實例 4：

有序列表嵌套有序列表

### 有序列表的嵌套

有序列表可以通過縮進實現(xiàn)嵌套

1. 項目 1
    1. 項目 1-1
1. 項目 2
    1. 項目 2-1
    1. 項目 2-2
1. 項目 3

無序列表的嵌套是沒有層數(shù)限制的

1. 第一層 1
    1. 第二層 1
        1. 第三層 1
            1. 第四層 1
                1. 第五層 1
        1. 第三層 2
    1. 第二層 2

其渲染結(jié)果如下：

實例 5：

有序列表和無序列表的混合嵌套

### 有序列表和無序列表混合嵌套

* 無序項目1-1
    1. 有序項目2-1
    1. 有序項目2-2
        - 無序項目3-1
        - 無序項目3-1
    1. 有序項目2-3

渲染結(jié)果如下：

實例 6：

在列表中嵌套其他內(nèi)容

### 列表中嵌套其他內(nèi)容

段落、圖片、引用等內(nèi)容可以通過縮進的方式進入到列表的結(jié)構(gòu)中。

* 帶段落的列表項

  在列表項中的段落

  * 帶段落的列表項

    在列表項中的段落

* 帶圖片的列表項

  ![](http://idcbgp.cn/static/img/index/logo.png)

  * 帶圖片的列表項

    ![](http://idcbgp.cn/static/img/index/logo.png)

* 帶引用的列表項

  > 引用內(nèi)容

  * 帶引用的列表項

    > 引用內(nèi)容

其渲染結(jié)果如下：

3. 使用場景及應用實例

列表的作用是有條理的顯示內(nèi)容，是一種非常方便的布局形式。

在一篇文章中，通常會用多級有序列表的方式來呈現(xiàn)文章的目錄結(jié)構(gòu)。通常會用無序列表呈現(xiàn)沒有明顯級別關系的分類，例如菜單項等。

實例 7：

如何用列表展示咖啡的制作說明

### 如何制作一杯咖啡

拿鐵咖啡是意大利濃縮咖啡與牛奶的經(jīng)典混合。  
炎炎夏日，來一杯冰咖啡不僅可以提神醒腦，更是身心的一種享受。

#### 用料

+ 主料
  - 咖啡粉
  - 牛奶
+ 輔料
  - 白砂糖
  - 熱水一杯

#### 做法

1. 準備好材料
2. 把咖啡粉和熱水沖在一起攪和
3. 把牛奶放進盤里用手動打蛋器打。記??！要一直打，打出細膩的奶泡。
4. 把打好的奶泡放入咖啡中，奶泡浮在上面就可以了。

其渲染結(jié)果如下：

4. 小結(jié)

1. 需要注意的是，書寫有序列表時，源碼中的順序號并不代表輸出后的序號，如果希望重新定義有序列表的起始數(shù)字，需要在兩個列表間插入兩個空行；
2. Markdown 的列表支持分段，即一個列表項的后續(xù)內(nèi)容，如果保持了同樣的縮進，后續(xù)內(nèi)容也是劃歸在列表里的。

列表是文章中用于呈現(xiàn)觀點的很好方式，也是常見的輔助功能項，例如文章目錄、或者樹形菜單、步驟圖等。