1.3 列表：三种清单的取舍

1.3 列表：三种清单的取舍

无序列表用减号，有序列表用数字加点，嵌套靠缩进。列表是 Markdown 里使用频率仅次于段落的结构，也是缩进规则最容易出问题的地方——这一节把三种清单连同那个经典排错案例一次讲透。

从一段并列信息开始

假设你在写部署步骤和依赖清单，直接敲：

依赖清单：
- 反向代理
- 应用运行时
- 数据库驱动

部署步骤：
1. 拉取代码
2. 安装依赖
3. 重启服务
​

无序列表三项符号（-、*、+）通用，我固定用减号：它和正文视觉冲突最小，也和大多数规范一致。有序列表的数字不必连续——你全写 1. 也能渲染出 1、2、3，因为渲染器自动重新编号。这个特性很实用：需要中途插入一条时，源码里的旧编号不用改。

⚠️ 常见坑：列表标记符（- 或 1.）后必须有一个空格，-项目 不会被识别为列表项。

嵌套：缩进的门道

子列表靠缩进表示层级。动手试这个：

- 环境准备
  - 安装运行时
  - 配置环境变量
- 构建与部署
  1. 编译产物
  2. 上传
  3. 切换流量
​

子项缩进了两个空格，正常嵌套。经典排错案例来了——把缩进改成 3 个或 5 个空格，或与父项标记错位：

- 父项一
   - 子项缩进 3 空格（部分平台解析正常）
- 父项二
      - 子项缩进 6 空格（可能掉出列表变成代码块）
​

不同解析器对嵌套缩进的宽容度不一致，稳妥做法：子项与父项文字起始列对齐（父项 - 占两列，子项就缩两格），并且全文档统一。

列表里的多段落

列表项不是只能装一行字。项内容换段需要缩进对齐：

1. 第一步说明。
   这行仍属于第一项（缩进对齐）。

   这段也属于第一项，但已是新段落。

2. 第二步说明。
​

忘记缩进，第二段就会"逃出"列表，编号也会断掉。这是列表排错中占比最高的一类问题。

三种清单怎么选

我自己的判断标准："先做 A 再做 B"用有序，"同时具备 A 和 B"用无序。把无序当有序用（读者自己去数位置）或反之，都是信息表达的浪费。

列表结构可视化

列表的克制：什么时候不该用列表

列表好用，好用到容易被滥用。三类内容其实不适合列表：第一类是有论证关系的论述——"因为 A 所以 B，因此 C"拆成三个列表项之后，逻辑连接词全部丢失，读者只看到三个孤立的断言，论证链断成三截。论述就该用段落写，让"因为、所以、但是"这些连接词承担它们的工作。第二类是每项需要多个属性对照的内容——比如对比三款工具的性能、许可证、依赖，列表写法要么信息挤在一行，要么嵌套层级爆炸，正确答案是表格（第 2 章的主角）。第三类是只有一项或两项的"伪列表"——单项列表徒增缩进和项目符号，直接一句话说完更干净。

列表还有个隐蔽的修辞效应：读者默认列表各项地位平等且都重要。把"必须做的两件事"和"可选的六件事"混在同一个无序列表里，读者无从分辨轻重。处理办法是拆成两个列表、各配一句小标题（"必做"与"可选"），或者干脆把必做项写进正文、可选项才落列表。列表的长度也值得控制：一个列表超过八项，读者的记忆负担就明显上升，要么分组拆成多个带小标题的列表，要么审视一下这些项是不是真的属于同一层——长列表常常是没做完的分类，硬塞进一个清单里而已。

紧列表与松列表：一个会被忽视的渲染差异

同一份列表源码，项与项之间有没有空行，渲染结果不一样：

- 紧凑列表
- 项间无空行
- 渲染为 <ul> 内相邻 <li>

- 宽松列表

- 项间有空行

- 每项会被包进 <p> 段落，行距变大
​

CommonMark 把前者叫 tight list（紧列表），后者叫 loose list（松列表）。视觉差别是松列表每项之间多出一段行距；更实际的差别在 CSS 与导出环节：有些主题给松列表的 <li> p 设置了不同边距，PDF 导出时松列表可能多占三分之一篇幅。团队规范建议默认写紧列表（项间不加空行），只有项内含多个段落时才自然形成松列表——顺其自然，不要手工用空行去"撑开"列表。

有序列表还有个值得知道的方言差异：起始编号。CommonMark 规定列表编号取第一项的数字：

5. 第五项
6. 第六项
​

渲染从 5 开始编号。但部分老解析器（以及某些 wiki 平台）一律从 1 重排。想让列表从非 1 数字开始的场景（比如接续上一节的步骤编号），务必在目标平台验证，别默认到处生效。另外 GFM 里有序列表标记后的分隔符，点号 1. 与括号 1) 都合法，混用两种分隔符会被视作两个列表——又一个"统一写法"的理由。

排错口诀汇总：**列表不渲染查空格，嵌套错乱查缩进，编号怪异查方言，段落逃逸查项内缩进。**四句话覆盖了列表九成的现场事故。

本节要点回顾

• 无序固定减号，有序数字随意但渲染自动重排。
• 嵌套缩进与父项文字对齐（两空格起步），全文档统一。
• 列表项内多段落必须缩进，否则段落逃逸、编号断裂。
• 选型标准：有顺序信息用有序，并列用无序，待办用任务列表。

编号的心理学：什么时候必须用有序列表

补充一个选型时容易被忽略的维度：有序列表向读者传递"总量预期"。看到"1. 2. 3."读者预期总共三步，步骤叙述中"第三步"可以被引用（"如第三步所述"）——有序编号给了各项一个稳定的名字。因此凡是后文要回引的步骤、以及总量本身是信息的内容（"部署只要四步"），必须用有序列表。反过来，无序列表项没有稳定引用名，长文档里"上面列表第三项"这类引用是脆弱的——列表一旦增删，序号全部漂移。回引需求强而内容又无序时，更稳的做法是给各项加粗小标题（列表项内首词加粗），引用"加粗小标题"而非位置。

列表与表格的选择演练

最后做一组三题速判：其一，"三款编辑器的价格、平台、插件数对比"——三个属性 × 三个对象的对位信息，表格；其二，"发布前要完成的检查项，做完一项勾一项"——状态型，任务列表；其三，"部署的六个步骤"——顺序型，有序列表，且因后文会引用"第四步的回滚"，编号本身就是引用锚。三题全对的判断依据都是信息形态而非个人偏好——这套速判做熟，列表与表格的选择从此不需要犹豫。