Markdown 列表（五）

5.列表

涵盖无序、有序、嵌套、任务列表及高级技巧。

一、无序列表

使用 *​、+​ 或 -​ 作为标记，标记后必须跟一个空格。

* 第一项
+ 第一项
- 第一项

建议：

• 统一使用 -（视觉最清晰）
• 同一文档中保持标记一致
• 标记后必须有空格

二、有序列表

使用数字 + 英文句点（如 1.），数字后跟空格。

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

特性：

• 实际显示的数字会自动按顺序排列（即使源码数字不连续）
• 可以从任意数字开始（后续依次递增）

1. 第一项
3. 第二项   （显示为 2）
7. 第三项   （显示为 3）

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

三、列表嵌套

3.1 无序列表嵌套

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

3.2 有序列表嵌套

1. 准备阶段
   1. 收集资料
   2. 制定计划
2. 执行阶段
   1. 开始实施

3.3 混合嵌套

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

嵌套规则：

• 子列表缩进 2-4 个空格（推荐 2 个）
• 保持缩进一致
• 可无限嵌套，但建议不超过 3 层

四、任务列表（复选框）

GitHub 风格扩展，现广泛支持。- [ ]

语法：

- [ ] 未完成的任务
- [x] 已完成的任务

实际示例：

## 项目待办清单

### 设计阶段
- [x] 需求分析
- [x] 原型设计
- [ ] UI 设计

### 开发阶段
- [ ] 前端开发
  - [x] 页面布局
  - [ ] 交互功能
- [ ] 后端开发

使用技巧：

• ​[ ]​ 中间有空格，[x] 小写 x
• 可与嵌套列表结合
• 部分编辑器支持点击切换状态

五、高级列表技巧

5.1 列表项包含多段内容

1. 第一项

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

2. 第二项

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

5.2 列表项内换行

不产生新段落

在两行文本之间加两个空格然后回车：

- 这是一个很长的列表项，  
  需要换行显示，第二行与第一行对齐
- 另一个列表项

总结速查表

列表类型	语法示例	注意
无序	​- 项目	标记后必须跟空格
有序	​1. 项目	数字自动修正顺序
嵌套	子项缩进 2 空格	推荐 2 空格
任务	​- [ ] 待办​ / - [x] 完成	空格与小写 x
多段内容	段落缩进对齐	保持与列表项对齐