基本语法

列表

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

  1. 项目符号列表
  2. 数字编号列表
  3. 列表项目内嵌套段落元素
  4. 列表自嵌套
  5. 列表项目内嵌套代码块
  6. 列表项目内嵌套其他元素

项目符号列表

项目符号列表,也叫做无序列表。

语法描述

使用连字符(-)、星号(*)或加号(+)作为列表中每个项目的开头。其中,最常用的是连字符。

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

示例

四大名著:

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

四大名旦:

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

前四大须生:

* 余叔岩
* 言菊朋
* 高庆奎
* 马连良

四大名著:

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

四大名旦:

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

前四大须生:

  • 余叔岩
  • 言菊朋
  • 高庆奎
  • 马连良
<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…”的输出效果相同。

示例

后四大须生:

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

四小名旦:

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

京剧四大流派:

1. 梅派
1. 程派
1. 荀派
1. 尚派

后四大须生:

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

四小名旦:

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

京剧四大流派:

  1. 梅派
  2. 程派
  3. 荀派
  4. 尚派
<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 个制表位。

示例

中国古代四大发明:

- 造纸术

- 指南针

- 火药

- 活字印刷术

中国新四大发明:

1. 高铁

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

2. 扫码支付

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

3. 网购

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

4. 共享单车

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

中国古代四大发明:

  • 造纸术

  • 指南针

  • 火药

  • 活字印刷术

中国新四大发明:

  1. 高铁

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

  2. 扫码支付

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

  3. 网购

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

  4. 共享单车

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

<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 个制表位。

示例

1. 老三鼎甲
    - 程长庚
    - 余三胜
    - 张二奎
2. 新三鼎甲
    - 谭鑫培
    - 汪桂芬
    - 孙菊仙
  1. 老三鼎甲
    • 程长庚
    • 余三胜
    • 张二奎
  2. 新三鼎甲
    • 谭鑫培
    • 汪桂芬
    • 孙菊仙
<ol>
  <li>老三鼎甲
    <ul>
      <li>程长庚</li>
      <li>余三胜</li>
      <li>张二奎</li>
    </ul>
  </li>
  
  <li>新三鼎甲
    <ul>
      <li>谭鑫培</li>
      <li>汪桂芬</li>
      <li>孙菊仙</li>
    </ul>
  </li>
</ol>

列表项目内嵌套代码块

语法描述

列表项目内嵌套代码块时,语法如下:

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

示例

1. HTML
        
        <html>
          <body>
            <h1>老生三鼎甲</h1>
          </body>
        </html>
        
2. CSS
3. JavaScript
  1. HTML

    <html>
      <body>
        <h1>老生三鼎甲</h1>
      </body>
    </html>
  2. CSS

  3. JavaScript

<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 个制表位。

示例

- 包龙图打坐在开封府

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

- 我正在城楼观山景
- 昔日有个三大贤
  • 包龙图打坐在开封府

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

  • 我正在城楼观山景

  • 昔日有个三大贤

<ul>
  <li><p>包龙图打坐在开封府</p>
    <blockquote>
      <p>京剧十大名段之一,取自《铡美案》。</p>
    </blockquote>
  </li>
  <li><p>我正在城楼观山景</p></li>
  <li><p>昔日有个三大贤</p></li>
</ul>