Markdown 支持有序列表和无序列表。
有序列表
语法规则:
数字序号 + 英文句号 + 空格 + 列表内容
示例:
1. 有序列表的第一项。
2. 有序列表的第二项。
3. 有序列表的第三项。
渲染效果:
- 有序列表的第一项。
- 有序列表的第二项。
- 有序列表的第三项。
无序列表
语法规则:
列表符(*/+/-) + 空格 + 列表内容
无序列表有三种列表符号可以用,分别是*
、+
、-
。这三种列表符的使用效果是一样的。
示例:
* 无序列表的第一项。
* 无序列表的第二项。
* 无序列表的第三项。
+ 无序列表的第四项。
+ 无序列表的第五项。
+ 无序列表的第六项。
- 无序列表的第七项。
- 无序列表的第八项。
- 无序列表的第九项。
渲染效果:
- 无序列表的第一项。
- 无序列表的第二项。
- 无序列表的第三项。
- 无序列表的第四项。
- 无序列表的第五项。
- 无序列表的第六项。
- 无序列表的第七项。
- 无序列表的第八项。
- 无序列表的第九项。
嵌套列表
有序列表和无序列表支持嵌套。
语法规则:
第一层列表
TAB + 第二层列表
TAB + TAB + 第三层列表
示例1:有序列表嵌套
1. 第一层列表第一项。
2. 第一层列表第二项。
1. 第二层列表第一项。
2. 第二层列表第二项。
1. 第三层列表第一项。
2. 第三层列表第二项。
3. 第二层列表第三项。
3. 第一层列表第三项
渲染效果:
- 第一层列表第一项。
- 第一层列表第二项。
- 第二层列表第一项。
- 第二层列表第二项。
- 第三层列表第一项。
- 第三层列表第二项。
- 第二层列表第三项。
- 第一层列表第三项
示例2:无序列表嵌套
- 第一层列表第一项。
- 第一层列表第二项。
- 第二层列表第一项。
- 第二层列表第二项。
- 第三层列表第一项。
- 第三层列表第二项。
- 第二层列表第三项。
- 第一层列表第三项
渲染效果:
- 第一层列表第一项。
- 第一层列表第二项。
- 第二层列表第一项。
- 第二层列表第二项。
- 第三层列表第一项。
- 第三层列表第二项。
- 第二层列表第三项。
- 第一层列表第三项
示例3:有序列表与无序列表互相嵌套
1. 第一层列表第一项。
2. 第一层列表第二项。
- 第二层列表第一项。
- 第二层列表第二项。
1. 第三层列表第一项。
2. 第三层列表第二项。
- 第二层列表第三项。
3. 第一层列表第三项
渲染效果:
- 第一层列表第一项。
- 第一层列表第二项。
- 第二层列表第一项。
- 第二层列表第二项。
- 第三层列表第一项。
- 第三层列表第二项。
- 第二层列表第三项。
- 第一层列表第三项
使用建议
-
无序列表使用
-
,不要用*
和+
。 -
建议在列表的前后都空1行,例如:
我的下面是一个列表,所以下方要先加一个空行。 - 我是列表第一项。 - 我是列表第二项。 - 我是列表第三项。 我的上面是一个列表,所以上方要加一个空行。
-
如果有序列表的每一项都只占一行,那么英文句号与列表项内容之间只加1个空格,并且每个列表项之间不要加空行。
建议方式:
1. 我只占1行。 2. 我只占1行。 3. 我只占1行。
不建议方式:
1. 我只占1行,但我和第二表项之间加了1个空行。 2. 我只占1行。 3. 我只占一行,但我在英文句号和列表项内容之间加了太多空格。
-
如果有序列表的列表项有需要换行的,那么所有列表项的英文句号和表项内容之间添加2个空格,并且每个列表项之间加1个空行。
建议方式:
1. 我是第一个表项的第一行。我的表项内容和英文句号之间有2个空格。 我是第一个表项的第二行。我的表项内容和行首之间有4个空格,刚好和第一行对齐。 2. 我是第二个表项,只有1行。 3. 我是第三个表项,只有1行。
不建议方式:
1. 我是第一个表项的第一行。但是我的表项内容和英文句号之间只有1个空格。 我是第一个表项的第二行。我的表项内容和行首之间有3个空格,这很奇怪,3个空格显得不专业。 2. 我是第二个表项,只有1行,但是我忘了和第三个表项之间加一行空格。 3. 我是第三个表项,只有1行。但是我忘了和第二个表项之间加一行空格。
-
如果无序列表的每一项都只占一行,那么列表符与列表项内容之间只加1个空格,并且每个列表项之间不要加空行。
建议方式:
- 我只占1行。 - 我只占1行。 - 我只占1行。
不建议方式:
- 我只占1行,但我和第二表项之间加了1个空行。 - 我只占1行。 - 我只占一行,但我在英文句号和列表项内容之间加了太多空格。
-
如果无序列表的列表项有需要换行的,那么所有列表项的列表符和表项内容之间添加3个空格,并且每个列表项之间加1个空行。
建议方式:
- 我是第一个表项的第一行。我的表项内容和列表符之间有3个空格。 我是第一个表项的第二行。我的表项内容和行首之间有4个空格,刚好和第一行对齐。 - 我是第二个表项,只有1行。 - 我是第三个表项,只有1行。
不建议方式:
- 我是第一个表项的第一行。但是我的表项内容和列表符之间只有1个空格。 我是第一个表项的第二行。我的表项内容和行首之间有2个空格,这很奇怪,2个空格显得不专业。 - 我是第二个表项,只有1行,但是我忘了和第三个表项之间加一行空格。 - 我是第三个表项,只有1行。但是我忘了和第二个表项之间加一行空格。