跳转至

列表

Markdown 可以创建多种形式的列表：

无序列表

无序列表，也叫做条目符号列表。

语法描述

使用连字符（-）、星号（*）或加号（+）作为列表每一条的开头。其中，最常用的是连字符。

连字符、星号或加号与条目文本之间必须输入一个或多个空格（或制表符）。

示例

Markdown
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
四大名著：

- 红楼梦
- 西游记
- 三国演义
- 水浒传

四大名旦：

+ 梅兰芳
+ 程砚秋
+ 尚小云
+ 荀慧生

前四大须生：

* 余叔岩
* 言菊朋
* 高庆奎
* 马连良
输出格式

四大名著：

  • 红楼梦
  • 西游记
  • 三国演义
  • 水浒传

四大名旦：

  • 梅兰芳
  • 程砚秋
  • 尚小云
  • 荀慧生

前四大须生：

  • 余叔岩
  • 言菊朋
  • 高庆奎
  • 马连良
HTML
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
<p>四大名著：</p>
<ul>
  <li>红楼梦</li>
  <li>西游记</li>
  <li>三国演义</li>
  <li>水浒传</li>
</ul>

<p>四大名旦：</p>
<ul>
  <li>梅兰芳</li>
  <li>程砚秋</li>
  <li>尚小云</li>
  <li>荀慧生</li>
</ul>

<p>前四大须生：</p>
<ul>
  <li>余叔岩</li>
  <li>言菊朋</li>
  <li>高庆奎</li>
  <li>马连良</li>
</ul>

有序列表

有序列表，也叫做数字编号列表。

语法描述

使用数字和句点（1.）作为列表中每个条目的开头。

数字和句点之间无空格，句点和条目文本之间必须输入一个或多个空格（或制表符）。

数字编号必须以 1 开始，但后面的数字顺序对输出效果没有任何影响。也就是说，列表编号“1、2、3、……”、“1、6、4、……”或“1、1、1、……”的输出效果相同。

示例

Markdown
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
后四大须生：

1. 马连良
2. 谭富英
3. 杨宝森
4. 奚啸伯

四小名旦：

1. 李世芳
5. 毛世来
3. 张君秋
8. 宋德珠

京剧四大流派：

1. 梅派
1. 程派
1. 荀派
1. 尚派
输出格式

后四大须生：

  1. 马连良
  2. 谭富英
  3. 杨宝森
  4. 奚啸伯

四小名旦：

  1. 李世芳
  2. 毛世来
  3. 张君秋
  4. 宋德珠

京剧四大流派：

  1. 梅派
  2. 程派
  3. 荀派
  4. 尚派
HTML
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
<p>后四大须生：</p>
<ol>
  <li>马连良</li>
  <li>谭富英</li>
  <li>杨宝森</li>
  <li>奚啸伯</li>
</ol>

<p>四小名旦：</p>
<ol>
  <li>李世芳</li>
  <li>毛世来</li>
  <li>张君秋</li>
  <li>宋德珠</li>
</ol>

<p>京剧四大流派：</p>
<ol>
  <li>梅派</li>
  <li>程派</li>
  <li>荀派</li>
  <li>尚派</li>
</ol>

列表内嵌套段落元素

列表条目（<li>）内可以嵌套一个或多个段落元素（<p>）。

语法描述

使用空行分隔每个列表条目，编译后的 HTML 代码中每个 <li> 元素中包含一个 <p> 元素，条目文本位于 <p> 元素中。

如果一个列表条目中包含多个段落：

  • 段落与段落之间插入一个空行。
  • 除了与项目符号或编号同处一行的段落之外，其他所有段落必须缩进 4 个空格或 1 个制表位。

示例

Markdown
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
中国古代四大发明：

- 造纸术

- 指南针

- 火药

- 活字印刷术

中国新四大发明：

1. 高铁

    1964年，日本建成世界上第一条高铁。2008年，中国第一条具有完全自主知识产权、时速 350 公里的京津城际高铁正式通车。

2. 扫码支付

    扫描用二维码由一家日本公司于 1994 年发明，而最先使用移动设备完成付款的是芬兰（1997年）。但扫码支付普及最快的国家当属中国无疑。

3. 网购

    1979年，英国人就已经发明了网络购物的概念。真正将概念转变为现实的是亚马逊和易贝。和扫码支付一样，在中国网购伴随着快递和支付的蓬勃发展而快速普及。

4. 共享单车

    共享单车最早出现在1965年的荷兰。2014年开始，共享单车开始在中国风靡。
输出格式

中国古代四大发明：

  • 造纸术

  • 指南针

  • 火药

  • 活字印刷术

中国新四大发明：

  1. 高铁

    1964年，日本建成世界上第一条高铁。2008年，中国第一条具有完全自主知识产权、时速 350 公里的京津城际高铁正式通车。

  2. 扫码支付

    扫描用二维码由一家日本公司于 1994 年发明，而最先使用移动设备完成付款的是芬兰（1997年）。但扫码支付普及最快的国家当属中国无疑。

  3. 网购

    1979年，英国人就已经发明了网络购物的概念。真正将概念转变为现实的是亚马逊和易贝。和扫码支付一样，在中国网购伴随着快递和支付的蓬勃发展而快速普及。

  4. 共享单车

    共享单车最早出现在1965年的荷兰。2014年开始，共享单车开始在中国风靡。

HTML
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
<p>中国古代四大发明：</p>
<ul>
  <li><p>造纸术</p></li>
  <li><p>指南针</p></li>
  <li><p>火药</p></li>
  <li><p>活字印刷术</p></li>
</ul>

<p>中国新四大发明：</p>
<ol>
  <li><p>高铁</p>
    <p>1964年，日本建成世界上第一条高铁。2008年，中国第一条具有完全自主知识产权、时速 350 公里的京津城际高铁正式通车。</p>
  </li>
  <li><p>扫码支付</p>
    <p>扫描用二维码由一家日本公司于 1994 年发明，而最先使用移动设备完成付款的是芬兰（1997年）。但扫码支付普及最快的国家当属中国无疑。</p>
  </li>
  <li><p>网购</p>
    <p>1979年，英国人就已经发明了网络购物的概念。真正将概念转变为现实的是亚马逊和易贝。和扫码支付一样，在中国网购伴随着快递和支付的蓬勃发展而快速普及。</p>
  </li>
  <li><p>共享单车</p>
    <p>共享单车最早出现在1965年的荷兰。2014年开始，共享单车开始在中国风靡。</p>
  </li>
</ol>

列表自嵌套

无论是无序列表还是有序列表，都可以自嵌套或相互嵌套以生成多级列表。

语法描述

二级或二级以上列表需要逐级缩进 4 个空格或 1 个制表位。

示例

Markdown
1
2
3
4
5
6
7
8
1. 老三鼎甲
    - 程长庚
    - 余三胜
    - 张二奎
2. 新三鼎甲
    - 谭鑫培
    - 汪桂芬
    - 孙菊仙
输出格式
  1. 老三鼎甲
    • 程长庚
    • 余三胜
    • 张二奎
  2. 新三鼎甲
    • 谭鑫培
    • 汪桂芬
    • 孙菊仙
HTML
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
<ol>
  <li>老三鼎甲
    <ul>
      <li>程长庚</li>
      <li>余三胜</li>
      <li>张二奎</li>
    </ul>
  </li>

  <li>新三鼎甲
    <ul>
      <li>谭鑫培</li>
      <li>汪桂芬</li>
      <li>孙菊仙</li>
    </ul>
  </li>
</ol>

列表内嵌套代码块

语法描述

列表条目内嵌套代码块时，语法如下：

  • 代码块前后必须各输入一个空行。
  • 代码块必须缩进 8 个空格或 2 个制表位。

示例

Markdown
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
1. HTML

        <html>
          <body>
            <h1>老生三鼎甲</h1>
          </body>
        </html>

2. CSS
3. JavaScript
输出格式

  1. HTML

    Text Only
    1
2
3
4
5
    <html>
  <body>
    <h1>老生三鼎甲</h1>
  </body>
</html>

  2. CSS

  3. JavaScript
HTML
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
<ol>
  <li><p>HTML</p>
    <pre><code>&lt;html&gt;
  &lt;body&gt;
    &lt;h1&gt;老生三鼎甲&lt;/h1&gt;
  &lt;/body&gt;
&lt;/html&gt;</code></pre>
  </li>
  <li><p>CSS</p></li>
  <li><p>JavaScript</p></li>
</ol>

列表内嵌套其他元素

列表条目内还可以嵌套引用、图片等多种元素。

语法描述

列表条目内嵌套其他元素时，语法如下：

  • 元素前后必须各输入一个空行。
  • 元素必须缩进 4 个空格或 1 个制表位。

示例

Markdown
1
2
3
4
5
6
- 包龙图打坐在开封府

    > 京剧十大名段之一，取自《铡美案》。

- 我正在城楼观山景
- 昔日有个三大贤
输出格式

  • 包龙图打坐在开封府

    京剧十大名段之一，取自《铡美案》。

  • 我正在城楼观山景

  • 昔日有个三大贤
HTML
1
2
3
4
5
6
7
8
9
<ul>
  <li><p>包龙图打坐在开封府</p>
    <blockquote>
      <p>京剧十大名段之一，取自《铡美案》。</p>
    </blockquote>
  </li>
  <li><p>我正在城楼观山景</p></li>
  <li><p>昔日有个三大贤</p></li>
</ul>