Markdown列表
跳到导航
跳到搜索
Markdown支持有序(编号)和无序(符号)列表。
- 无序列表使用星号、加号和连字符作为列表标记:
* 红色 * 绿色 * 蓝色
等同于:
+ 红色 + 绿色 + 蓝色
以及:
- 红色 - 绿色 - 蓝色
- 有序列表使用数字后跟句点:
1. 鸟 2. 鱼 3. 兽
需要注意的是,您在列表中使用的实际数字对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
但如果你想懒一点,你也可以不这样做:
* A B C * D E
如果列表项之间用空行分隔,Markdown将在HTML输出中将列表项包装在<p>标签中。例如,以下输入:
* Bird * Magic
将变成:
<ul> <li>Bird</li> <li>Magic</li> </ul>
但是这样的输入:
* Bird * Magic
将变成:
<ul> <li><p>Bird</p></li> <li><p>Magic</p></li> </ul>
列表项可以由多个段落组成。每个列表项中的后续段落必须缩进4个空格或一个制表符:
1. 这是一个包含两个段落的列表项。 A B C D E 2. F
如果每个后续段落的每一行都缩进了,看起来很好,但是Markdown也允许您懒一点:
* 这是一个包含两个段落的列表项。 这是列表项中的第二个段落。您只需要缩进第一行。 A * 同一列表中的另一项。
要在列表项中插入引用块,引用块的>分隔符需要缩进:
* 带有引用块的列表项: > 这是一个位于列表项中的引用块。
要在列表项中插入代码块,代码块需要缩进两次-8个空格或两个制表符:
* 带有代码块的列表项: <此处放置代码>