Markdown 列表制作完全指南：无序、有序、任务列表与代码示例

写笔记的时候，有没有遇到过这种抓狂时刻——文字堆在一起，密密麻麻全是字，看着就头疼？或者好不容易排版好了，换个编辑器一看全乱了？

别急，今天咱们就来好好聊聊 Markdown 列表这回事。

先说点真心话

我自己一开始也是被 Markdown 列表搞懵过。那时候用纯文本写文档，全靠空格对齐，稍微改几个字就全歪了。后来用了 Markdown，才发现原来列表可以这么优雅地搞定。

不管是记笔记、写文档、做计划，还是录代码示例，列表都是最实用的工具之一。今天我把压箱底的经验全拿出来，包你看完就能上手。

---

一、无序列表：那种随意但有秩序的感觉

无序列表就是没有编号的列表，用 -、* 或者 + 开头都能实现。

基础用法

- 苹果
- 香蕉
- 橙子

效果是这样的：

• 苹果
• 香蕉
• 橙子

你看，就是这么简单。符号前面加一个空格，后面接内容，完事儿。

符号能随便换吗？

可以。-、*、+ 都能用，效果一样：

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

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

但说实话，大多数人用 - 比较多，因为好打，看着也清爽。

嵌套多级列表

真实场景里，列表往往不是一层的。比如你整理旅行清单：

- 衣物
  - 内衣
  - 衬衫
  - 外套
    - 轻薄款（推荐）
    - 保暖款
- 证件
  - 身份证
  - 护照
  - 学生证
- 电子产品
  - 手机充电器
  - 充电宝
  - 耳机

关键就一个：缩进两个空格。

• 衣物
  • 内衣
  • 衬衫
  • 外套
    • 轻薄款（推荐）
    • 保暖款
  • 证件
  • 电子产品

看着整齐吧？只要记住缩进规则，多层嵌套完全没问题。

实战示例：读书笔记

- 《三体》笔记
  - 核心概念
    - 黑暗森林法则
    - 面壁计划
    - 水滴探测器
  - 印象最深的句子
    - "给岁月以文明，而不是给文明以岁月"
  - 作者观点
    - 对宇宙社会学的推导很有意思
    - 人性在极端环境下的描写很真实

• 《三体》笔记
  • 核心概念
    • 黑暗森林法则
    • 面壁计划
    • 水滴探测器
  • 印象最深的句子
    • “给岁月以文明，而不是给文明以岁月”
  • 作者观点
    • 对宇宙社会学的推导很有意思
    • 人性在极端环境下的描写很真实

这样整理，复习的时候一眼就能看到重点在哪里。

---

二、有序列表：强调顺序和优先级

有序列表适合需要体现先后顺序、步骤流程的场景。

基础用法

用数字加英文句号，注意要加空格：

1. 第一步：准备材料
2. 第二步：开始操作
3. 第三步：检查结果
4. 第四步：完成收尾

1. 第一步：准备材料
2. 第二步：开始操作
3. 第三步：检查结果
4. 第四步：完成收尾

数字从中间开始也行

如果你想从某个数字开始编号：

5. 这是第五条
6. 这是第六条
7. 这是第七条

1. 这是第五条
2. 这是第六条
3. 这是第七条

有些编辑器会自动识别，但保险起见，建议还是按顺序写。

嵌套有序列表

1. 准备工作
   1. 购买材料
   2. 清理桌面
   3. 打开电脑
2. 开始制作
   1. 按照图纸拼装
   2. 焊接电路板
   3. 测试功能
3. 后续工作
   1. 清理现场
   2. 记录数据
   3. 分享成果

1. 准备工作
   1. 购买材料
   2. 清理桌面
   3. 打开电脑
2. 开始制作
   1. 按照图纸拼装
   2. 焊接电路板
   3. 测试功能
3. 后续工作
   1. 清理现场
   2. 记录数据
   3. 分享成果

混合使用无序和有序也很常见：

## 周末计划

1. 上午
   - 睡到自然醒
   - 做顿丰盛的早餐
   - 出门逛逛菜市场
2. 下午
   - 整理房间
   - 看一部电影
   - 写读书笔记
3. 晚上
   - 和朋友聚餐
   - 散步回家
   - 早点休息

1. 上午
   • 睡到自然醒
   • 做顿丰盛的早餐
   • 出门逛逛菜市场
2. 下午
   • 整理房间
   • 看一部电影
   • 写读书笔记
3. 晚上
   • 和朋友聚餐
   • 散步回家
   • 早点休息

这样一天安排得明明白白，执行起来特别有思路。

---

三、任务列表：待办事项的优雅表达

任务列表是 Markdown 的一个特色功能，用方括号里面加空格或叉来表示勾选状态。

基础写法

- [ ] 还没完成的任务
- [x] 已经完成的任务
- [ ] 另一个待办

效果：

• [ ] 还没完成的任务
• [x] 已经完成的任务
• [ ] 另一个待办

注意：方括号和横杠之间有一个空格，方括号里面也是空格（未完成）或 x（已完成）。

实战场景：项目管理

## 本周工作清单

- [x] 完成项目周报
- [x] 修复登录页面的 bug
- [ ] 准备明天会议的材料
- [ ] 审核新员工的代码提交
- [ ] 更新项目文档
- [x] 回复客户邮件

• [x] 完成项目周报
• [x] 修复登录页面的 bug
• [ ] 准备明天会议的材料
• [ ] 审核新员工的代码提交
• [ ] 更新项目文档
• [x] 回复客户邮件

看着已经勾选的条目，是不是特有成就感？

嵌套任务列表

## 装修进度

- [x] 设计阶段
  - [x] 确定风格
  - [x] 出效果图
  - [x] 签订设计合同
- [ ] 施工阶段
  - [ ] 拆除旧装修
  - [ ] 水电改造
  - [ ] 贴砖
- [ ] 软装阶段
  - [ ] 买家具
  - [ ] 挂窗帘
  - [ ] 进软装

• [x] 设计阶段
  • [x] 确定风格
  • [x] 出效果图
  • [x] 签订设计合同
• [ ] 施工阶段
  • [ ] 拆除旧装修
  • [ ] 水电改造
  • [ ] 贴砖
• [ ] 软装阶段
  • [ ] 买家具
  • [ ] 挂窗帘
  • [ ] 进软装

这样把大任务拆成小任务，每个小任务勾选一次，推进感很强。

学习打卡模板

## Python 学习打卡 - 第四周

- [x] Day 1：复习列表推导式
- [x] Day 2：学习字典的高级用法
- [x] Day 3：尝试写一个爬虫
- [ ] Day 4：学习 Flask 框架基础
- [ ] Day 5：完成一个小项目
- [ ] Day 6：整理学习笔记
- [ ] Day 7：复习本周内容

• [x] Day 1：复习列表推导式
• [x] Day 2：学习字典的高级用法
• [x] Day 3：尝试写一个爬虫
• [ ] Day 4：学习 Flask 框架基础
• [ ] Day 5：完成一个小项目
• [ ] Day 6：整理学习笔记
• [ ] Day 7：复习本周内容

每天勾选，既像打怪升级一样有趣，又能清楚看到自己的进度。

---

四、代码示例：列表的进阶用法

混合列表的缩进技巧

很多人写到嵌套列表就乱，关键就是缩进要统一。我用两个空格作为一级缩进，四个空格作为二级，这样最清晰：

## 产品需求文档

### 功能模块一：用户系统
- [x] 注册登录
  - [x] 手机号注册
  - [x] 微信登录
  - [ ] 邮箱注册
- [ ] 个人中心
  - [ ] 修改头像
  - [ ] 修改昵称
  - [ ] 实名认证

### 功能模块二：内容系统
- [ ] 发布功能
  - [ ] 文字发布
  - [ ] 图片发布
  - [ ] 视频发布
- [ ] 浏览功能
  - [ ] 首页推荐
  - [ ] 分类浏览
  - [ ] 搜索功能

列表和段落混排

## 会议记录

### 参会人
- 张三（产品经理）
- 李四（设计师）
- 王五（前端开发）
- 赵六（后端开发）

### 会议内容
我们讨论了下个版本的几个重点功能。首先确认了用户系统的优先级最高，因为这是基础功能，影响所有用户的使用体验。

然后讨论了内容系统的发布功能，设计师提出了新的交互方案，认为可以减少三步操作。

最后确定了排期，计划在下周五完成用户系统的核心功能开发。

### 待办事项
- [ ] 张三整理需求文档
- [ ] 李四输出设计稿
- [ ] 王五搭建开发环境
- [ ] 赵六设计数据库表结构

---

五、常见问题与避坑指南

问题一：列表不连续了

有时候写成这样：

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

但渲染出来跳号了，或者中间断开了。

原因通常是：换行了。如果你在一个列表项里面换行，记得前面加两个空格：

1. 这是一个长条目
   这是续行内容，前面要加两个空格
   再加一行也没问题
2. 下一个条目

问题二：代码块里的列表

如果你想在代码示例里展示列表，记得用反引号包裹：

```
- 苹果
- 香蕉
- 橙子
```

或者用 HTML 的 <pre> 标签：

<pre>
- 苹果
- 香蕉
- 橙子
</pre>

问题三：任务列表在某些平台不支持

Notion、GitHub 的 README、语雀等都支持任务列表，但有些地方可能渲染不出来。如果遇到这种情况，可以先用普通的无序列表代替，等需要的时候再手动改成任务列表。

问题四：序号自动递增

有些编辑器会自动把序号变成 1、2、3 的顺序，不管你写什么数字。这其实是好事，但如果你需要跳号，最好手动检查渲染效果。

---

六、不同场景的列表模板

读书笔记模板

## 《XXX》读书笔记

**作者：** 作者名
**阅读日期：** 2024年1月
**评分：** ⭐⭐⭐⭐

### 核心观点
- 观点一：XXX
- 观点二：XXX
- 观点三：XXX

### 金句摘录
1. "第一句金句"
2. "第二句金句"
3. "第三句金句"

### 行动清单
- [ ] 实践第一章的方法
- [ ] 分享读书笔记给朋友
- [ ] 三个月后回顾本书

旅行清单模板

## 日本旅行清单 - 大阪7日游

### 必带物品
- [x] 护照
- [x] 身份证
- [x] 充电宝
- [x] 转换插头
- [ ] 相机（记得买电池）
- [ ] 防晒霜
- [ ] 常用药品

### 行程备忘
- [ ] Day 1：到达大阪，入住酒店
- [ ] Day 2：环球影城
- [ ] Day 3：大阪城 + 难波逛街
- [ ] Day 4：奈良喂鹿
- [ ] Day 5：京都一日游
- [ ] Day 6：神户 + 自由购物
- [ ] Day 7：返程

周报模板

## 工作周报 - 第X周

### 本周完成
- [x] 完成XX功能开发
- [x] 修复3个线上bug
- [x] 参加产品评审会议

### 进行中
- [ ] 用户系统重构（进度70%）
- [ ] 接口文档编写（进度50%）
- [ ] 性能优化方案（进度30%）

### 下周计划
- [ ] 完成用户系统重构
- [ ] 提交接口文档
- [ ] 性能优化方案评审
- [ ] 配合测试同学验收功能

---

七、一些实用小技巧

技巧一：用列表做快速记忆

把知识点拆成条目，比大段文字好记多了。比如背单词的时候：

## 本周要背的单词

- [ ] abandon - 放弃
- [ ] ability - 能力
- [ ] abnormal - 异常的
- [ ] abondon - ❌ 这是错的！
- [ ] abolish - 废除
- [ ] abort - 中止

技巧二：用列表做方案对比

## 数据库选型对比

| 选项 | 优点 | 缺点 | 推荐度 |
|------|------|------|--------|
| MySQL | 稳定、生态好 | 高并发有瓶颈 | ⭐⭐⭐⭐ |
| PostgreSQL | 功能强、扩展好 | 学习曲线陡 | ⭐⭐⭐⭐⭐ |
| MongoDB | 灵活、schemaless | 复杂查询弱 | ⭐⭐⭐ |

技巧三：用列表整理灵感

想到啥就记啥，不用管顺序，回头再整理：

## 灵感碎片

- 产品可以做一个夜间模式
- 那个按钮的交互有点问题
- 用户反馈说找不到功能入口
- 试试用渐变背景
- 参考一下XXX产品的做法
- 下次开会可以提这个建议

等灵感积累多了，再归类到正式的文档里。

---

结语：列表用好了，文档事半功倍

说实话，Markdown 列表这东西，入门特别简单，但用好需要点手感。

我建议你今天就试着整理一份自己的文档——不管是学习计划、工作待办、还是读书笔记，用列表重新排一下版。一开始可能会慢一点，但习惯之后，速度会比纯文字快很多，而且看着舒服。

最重要的是，列表让信息有了层次。读者一眼就能看出哪些是重点、哪些是补充、哪些是后续要做的事。这种阅读体验，是纯文字很难做到的。

多写多练，你会发现自己越来越喜欢用列表。