Markdown-04-列表
Markdown 支持有序列表和无序列表。
无序列表
无序列表使用 -、 *、+ 作为列表标记,这些标记后面要添加一个空格,然后再填写内容:
- 第一项
- 第二项
- 第三项
* 第一项
* 第二项
* 第三项
+ 第一项
+ 第二项
+ 第三项
效果:
- 第一项
- 第二项
- 第三项
选择建议:
- 建议统一使用
-,因为它在视觉上最清晰 - 在同一文档中保持一致的标记方式
- 标记符号后必须有一个空格
有序列表
有序列表用于展示有顺序要求的步骤或项目。
有序列表使用数字并加上 . 号来表示:
1. 第一项
2. 第二项
3. 第三项
效果:
- 第一项
- 第二项
- 第三项
注意:数字可以不连续,Markdown 会自动修正数字顺序,但还是建议输入连续的数字。
也支持从指定数字开始:
5. 第五项
6. 第六项
7. 第七项
效果:
- 第五项
- 第六项
- 第七项
列表嵌套
列表可以嵌套使用,创建多层次的结构:
无序列表嵌套:
- 水果
- 苹果
- 红苹果
- 绿苹果
- 香蕉
- 橙子
- 蔬菜
- 胡萝卜
- 白菜
效果:
- 水果
- 苹果
- 红苹果
- 绿苹果
- 香蕉
- 橙子
- 苹果
- 蔬菜
- 胡萝卜
- 白菜
有序列表嵌套:
1. 准备阶段
2. 收集资料
3. 制定计划
4. 执行阶段
5. 开始实施
6. 监控进度
7. 总结阶段
效果:
- 准备阶段
2. 收集资料
3. 制定计划 - 执行阶段
5. 开始实施
6. 监控进度 - 总结阶段
混合嵌套:
1. 主要任务
- 子任务A
- 子任务B
1. 详细步骤1
2. 详细步骤2
- 子任务C
1. 次要任务
效果:
- 主要任务
- 子任务A
- 子任务B
- 详细步骤1
- 详细步骤2
- 子任务C
- 次要任务
列表混合嵌套只需在子列表中的选项前面添加两个或四个空格即可:
1. 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
2. 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第二个元素
效果:
- 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
- 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第二个元素
嵌套规则:
- 子列表需要缩进 2-4 个空格(推荐 2 个)
- 保持一致的缩进长度
- 可以无限层嵌套,但实际使用中建议不超过 3 层
任务列表
任务列表是 GitHub 风格 Markdown 的扩展功能,现在被广泛支持:
基本语法:
- [ ] 未完成的任务
- [x] 已完成的任务
- [ ] 另一个未完成的任务
效果:
实际应用示例:
-
设计阶段
-
开发阶段
-
-
-
测试阶段
使用技巧:
- 方括号内的空格和 x 很重要:
[ ]和[x] - 可以与嵌套列表结合使用
- 在项目管理、学习计划、生活清单中特别有用
- 某些编辑器支持点击复选框来切换状态
高级列表技巧:
- 列表项中包含多段内容:
1. 第一项
这是第一项的详细说明,需要与列表项对齐缩进。
还可以包含第二段内容。
2. 第二项
> 可以在列表项中使用引用
效果:
-
第一项
这是第一项的详细说明,需要与列表项对齐缩进。
还可以包含第二段内容。
-
第二项
可以在列表项中使用引用
- 列表项中的换行:
- 这是一个很长的列表项,
需要换行显示,注意第二行需要与第一行对齐
- 另一个列表项
效果:
- 这是一个很长的列表项,
需要换行显示,注意第二行需要与第一行对齐 - 另一个列表项
天河有尽后为涯 星海无边前作岸

浙公网安备 33010602011771号