Markdown 列表语法

00:00

4 min Intermediate 2026/4/6

有序列表、无序列表、任务列表与嵌套规则。

1. 无序列表 (Unordered Lists)

1.1 语法

使用 -、* 或 + 加空格开头，三者效果完全一致，推荐统一使用 - 以保持一致性。

-
-
-

1.2 渲染效果

无序列表项 1
无序列表项 2
无序列表项 3

1.3 高级用法

1.3.1 列表项换行

如果列表项内容较长，需要换行时，第二行及以后的内容需要与第一行文本对齐，而不是与标记符对齐：

- 换行后需要与第一行文本对齐，
  而不是与标记符对齐
-

渲染效果：

这是一个很长的列表项，换行后需要与第一行文本对齐，而不是与标记符对齐
另一个列表项

1.3.2 列表项中的空行

列表项之间可以添加空行，提高可读性：

-
-
-

渲染效果：

列表项 1
列表项 2
列表项 3

2. 有序列表 (Ordered Lists)

2.1 语法

使用 数字 + 英文句号 + 空格 开头，数字顺序不影响最终渲染结果，推荐按顺序书写以保持代码的可读性。

1.  有序列表项 1
2.  有序列表项 2
3.  有序列表项 3

2.2 渲染效果

有序列表项 1
有序列表项 2
有序列表项 3

2.3 高级用法

2.3.1 序号自动调整

即使使用非连续的数字，渲染时也会自动调整为连续序号：

1.  第一项
2.  第二项（使用了数字 3）
3.  第三项（使用了数字 2）

渲染效果：

第一项
第二项（使用了数字 3）
第三项（使用了数字 2）

2.3.2 多级有序列表

多级有序列表的序号会自动递增：

1. 一级列表项
1. 二级列表项
1. 三级列表项
1. 另一个二级列表项
1. 另一个一级列表项

渲染效果：

一级列表项
二级列表项
三级列表项
另一个二级列表项
另一个一级列表项

3. 任务列表 (Task Lists)

3.1 语法

待办清单专用语法（GFM 扩展），[ ] 表示未完成，[x] 表示已完成，符号后必须加空格。

-
-
-

- [x] 子任务 1
- [ ] 子任务 2

3.2 渲染效果

3.3 高级用法

3.3.1 任务列表与描述

可以在任务列表项后添加描述文本：

- 详细描述：需要包含项目背景、目标、计划和预算
- 详细描述：讨论项目进度和下一步计划

渲染效果：

完成项目提案详细描述：需要包含项目背景、目标、计划和预算
召开团队会议详细描述：讨论项目进度和下一步计划

4. 嵌套列表 (Nested Lists)

4.1 语法

嵌套列表需要使用4 个空格或 1 个制表符进行缩进。

4.1.1 无序列表嵌套

-

- 二级无序列表项
- ## 三级无序列表项

4.1.2 有序列表嵌套

1. 一级有序列表项
1. 二级有序列表项
1. 三级有序列表项
1. 另一个一级有序列表项

4.1.3 混合嵌套

-

1. 有序列表项

- 无序列表项

1. 有序列表项

4.2 渲染效果

一级无序列表项
二级无序列表项
三级无序列表项
另一个一级无序列表项

一级有序列表项
二级有序列表项
三级有序列表项
另一个一级有序列表项

无序列表项

有序列表项

无序列表项

有序列表项

4.3 嵌套列表的最佳实践

控制嵌套层级：一般不超过 3 层，过深的嵌套会降低可读性
保持缩进一致：使用统一的缩进方式（4 个空格或 1 个制表符）
添加空行：在不同层级的列表之间添加空行，提高可读性
使用不同类型：根据内容需要选择合适的列表类型进行嵌套

5. 列表与其他元素的结合

5.1 列表中使用代码块

-

```python
print("Hello, World!")
```

console.log('Hello, World!');


渲染效果：
- 列表项 1
```python
 print("Hello, World!")

列表项 2

console.log('Hello, World!');

5.2 列表中使用引用

-

> 这是一个引用
> 可以跨越多行
> True- 列表项 2
> 另一个引用

渲染效果：

列表项 1

这是一个引用可以跨越多行
列表项 2

另一个引用

5.3 列表中使用图片和链接

-
-

渲染效果：

列表项 1：Markdown 指南
列表项 2：

6. 不同 Markdown 解析器的兼容性

不同的 Markdown 解析器对列表语法的支持可能略有差异：

解析器	无序列表	有序列表	任务列表	嵌套列表
GitHub Flavored Markdown	支持	支持	支持	支持
CommonMark	支持	支持	不支持	支持
Markdown.pl	支持	支持	不支持	支持
MultiMarkdown	支持	支持	不支持	支持
注意：任务列表是 GitHub Flavored Markdown (GFM) 的扩展特性，在其他解析器中可能不被支持。