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