Markdown-04-列表

Markdown 支持有序列表和无序列表。

无序列表

无序列表使用 -、 *、+ 作为列表标记,这些标记后面要添加一个空格,然后再填写内容:

- 第一项
- 第二项
- 第三项

* 第一项
* 第二项
* 第三项

+ 第一项
+ 第二项
+ 第三项

效果:

  • 第一项
  • 第二项
  • 第三项

选择建议:

  • 建议统一使用 -,因为它在视觉上最清晰
  • 在同一文档中保持一致的标记方式
  • 标记符号后必须有一个空格

有序列表

有序列表用于展示有顺序要求的步骤或项目。

有序列表使用数字并加上 . 号来表示:

1. 第一项
2. 第二项
3. 第三项

效果:

  1. 第一项
  2. 第二项
  3. 第三项

注意:数字可以不连续,Markdown 会自动修正数字顺序,但还是建议输入连续的数字。

也支持从指定数字开始:

5. 第五项
6. 第六项
7. 第七项

效果:

  1. 第五项
  2. 第六项
  3. 第七项

列表嵌套

列表可以嵌套使用,创建多层次的结构:

无序列表嵌套:

- 水果
  - 苹果
    - 红苹果
    - 绿苹果
  - 香蕉
  - 橙子
- 蔬菜
  - 胡萝卜
  - 白菜

效果:

  • 水果
    • 苹果
      • 红苹果
      • 绿苹果
    • 香蕉
    • 橙子
  • 蔬菜
    • 胡萝卜
    • 白菜

有序列表嵌套:

1. 准备阶段
   2. 收集资料
   3. 制定计划
4. 执行阶段
   5. 开始实施
   6. 监控进度
7. 总结阶段

效果:

  1. 准备阶段
    2. 收集资料
    3. 制定计划
  2. 执行阶段
    5. 开始实施
    6. 监控进度
  3. 总结阶段

混合嵌套:

1. 主要任务
   - 子任务A
   - 子任务B
     1. 详细步骤1
     2. 详细步骤2
   - 子任务C
1. 次要任务

效果:

  1. 主要任务
    • 子任务A
    • 子任务B
      1. 详细步骤1
      2. 详细步骤2
    • 子任务C
  2. 次要任务

列表混合嵌套只需在子列表中的选项前面添加两个或四个空格即可:

1. 第一项:
    - 第一项嵌套的第一个元素
    - 第一项嵌套的第二个元素
2. 第二项:
    - 第二项嵌套的第一个元素
    - 第二项嵌套的第二个元素

效果:

  1. 第一项:
    • 第一项嵌套的第一个元素
    • 第一项嵌套的第二个元素
  2. 第二项:
    • 第二项嵌套的第一个元素
    • 第二项嵌套的第二个元素

嵌套规则:

  • 子列表需要缩进 2-4 个空格(推荐 2 个)
  • 保持一致的缩进长度
  • 可以无限层嵌套,但实际使用中建议不超过 3 层

任务列表

任务列表是 GitHub 风格 Markdown 的扩展功能,现在被广泛支持:

基本语法:

- [ ] 未完成的任务
- [x] 已完成的任务
- [ ] 另一个未完成的任务

效果:

实际应用示例:

  • 设计阶段

  • 开发阶段

  • 测试阶段

使用技巧:

  • 方括号内的空格和 x 很重要:[ ] 和 [x]
  • 可以与嵌套列表结合使用
  • 在项目管理、学习计划、生活清单中特别有用
  • 某些编辑器支持点击复选框来切换状态

高级列表技巧:

  • 列表项中包含多段内容:
1. 第一项

   这是第一项的详细说明,需要与列表项对齐缩进。
   
   还可以包含第二段内容。

2. 第二项

   > 可以在列表项中使用引用

效果:

  1. 第一项

    这是第一项的详细说明,需要与列表项对齐缩进。

    还可以包含第二段内容。

  2. 第二项

    可以在列表项中使用引用

  • 列表项中的换行:
- 这是一个很长的列表项,
  需要换行显示,注意第二行需要与第一行对齐
- 另一个列表项

效果:

  • 这是一个很长的列表项,
    需要换行显示,注意第二行需要与第一行对齐
  • 另一个列表项
posted @ 2026-09-30 17:28  天航星  阅读(2)  评论(0)    收藏  举报