现在位置: 首页 > Markdown 教程 > 正文

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 文档了。这些语法是日常写作中最常用的,熟练掌握它们将大大提高你的文档编写效率。