Markdown列表

来自泡泡学习笔记
跳到导航 跳到搜索

Markdown支持有序(编号)和无序(符号)列表。


  • 无序列表使用星号、加号和连字符作为列表标记:
* 红色
* 绿色
* 蓝色

Markdown列表-1.png


等同于:

+ 红色
+ 绿色
+ 蓝色

以及:

- 红色
- 绿色
- 蓝色


  • 有序列表使用数字后跟句点:
 1. 鸟
 2. 鱼
 3. 兽

Markdown列表-2.png


需要注意的是,您在列表中使用的实际数字对Markdown生成的HTML输出没有影响。Markdown从上述列表生成的HTML是:

<ol>
<li>鸟</li>
<li>鱼</li>
<li>兽</li>
</ol>


如果您将列表以这种方式在Markdown中编写:

1. 鸟
1. 鱼
1. 兽


甚至是:

3. 鸟
1. 鱼
8. 兽


您将获得完全相同的HTML输出。关键是,如果您愿意,您可以在有序的Markdown列表中使用序数,以便源中的数字与发布的HTML中的数字匹配。但如果你想懒一点,你也可以不这样做。


然而,如果您使用懒惰的列表编号,仍然应该从数字1开始。在将来的某个时候,Markdown可能支持从任意数字开始有序列表。


列表标记通常从左边距开始,但可以缩进最多三个空格。列表标记后必须跟随一个或多个空格或制表符。

为了使列表看起来漂亮,您可以使用悬挂缩进包装项目:

* A
  B
  C
* D
  E

Markdown列表-3.png


但如果你想懒一点,你也可以不这样做:

* A
B
C
* D
E


如果列表项之间用空行分隔,Markdown将在HTML输出中将列表项包装在<p>标签中。例如,以下输入:

* Bird
* Magic

Markdown列表-4.png

将变成:

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


但是这样的输入:

* Bird

* Magic

Markdown列表-5.png


将变成:

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


列表项可以由多个段落组成。每个列表项中的后续段落必须缩进4个空格或一个制表符:

1. 这是一个包含两个段落的列表项。
   A
   B

   C
   D
   E

2. F

Markdown列表-6.png


如果每个后续段落的每一行都缩进了,看起来很好,但是Markdown也允许您懒一点:

* 这是一个包含两个段落的列表项。

  这是列表项中的第二个段落。您只需要缩进第一行。
A

* 同一列表中的另一项。

Markdown列表-7.png


要在列表项中插入引用块,引用块的>分隔符需要缩进:

* 带有引用块的列表项:

  > 这是一个位于列表项中的引用块。

Markdown列表-8.png


要在列表项中插入代码块,代码块需要缩进两次-8个空格或两个制表符:

* 带有代码块的列表项:

      <此处放置代码>


Markdown列表-9.png