办公文档 · 实用教程
Markdown有序列表为什么不按手写数字显示:起始编号、续接与重开怎么检查
源码写1、1、1却显示1、2、3,插入说明后编号又重置?用短示例检查Markdown列表的起始数字、段落和代码块归属,以及独立列表的重新编号。
先看结论
Markdown 有序列表通常由渲染器连续编号。按 CommonMark 规则,同一列表只用第一项的数字确定起点,后续源码数字不决定各项显示编号。因此,源码连续写三个 `1.`,显示为 1、2、3 是正常行为;想重新从 1 开始,仅把中间某项改为 `1.` 不够,还需要让它成为一份新列表。[CommonMark 列表规则](https://spec.commonmark.org/0.31.2/#lists)明确说明了这一点。
打开相关入口开始前先确认
排错时先确定目标:你要的是连续操作步骤、分段后的接续步骤,还是两组各自编号的任务。三种目标对应不同结构。
先用三行确认编号起点
以下是假设的交接步骤,用来观察符合 CommonMark 规则的渲染结果:
4. 检查文件名
1. 核对附件
9. 交付文档这是一份从 4 开始的列表,预期编号是 4、5、6,而不是源码中的 4、1、9。不要通过修改第二、第三项的数字修复跳号;先看第一项,以及这三行是否被解析为同一列表。
如果任务要求保留“问题 4、问题 9、问题 15”这样的固定编号,建议把编号写进表格字段或正文标签,例如“问题 9:附件缺失”。固定编号承担识别作用,连续列表承担排序作用,选择能准确表达用途的形式更便于后续增删。
插入说明后继续编号:先让说明归属正确
假设第二步需要附加一段解释,第三步仍属于同一流程,可以这样写:
1. 收集文件
2. 核对附件
附件名称应与交接清单一致。
3. 交付文档这里的说明段落前有三个空格,与 2. 后的正文起点对齐。它表达的是“第二项中的补充说明”。列表项内后续块的缩进与列表标记和正文起点有关,不能把一个固定空格数套用到所有编号宽度;具体规则见 CommonMark 列表项说明。
操作时先检查说明属于哪一步,再调整缩进。如果还包含子步骤,可参考 Markdown 列表缩进排错区分附属内容与下一层列表,不必为了修正显示数字重排整篇文章。
如果插入的是代码示例,同样要检查其归属。下面是另一段假设性源码,代码块放在第二项内部:
1. 收集文件
2. 查看命名示例
```text
report_final.md
```
3. 交付文档当代码之后的编号异常,优先检查围栏是否成对、缩进是否仍对应第二项。需要核对代码边界时,可使用 Markdown 代码块写法与排错。改数字不能补救一个归属错误的代码块。
独立段落之后续接,与新阶段从 1 开始
若说明讨论整个流程,应让它成为列表外的独立段落,再显式写出后半段的起始编号:
1. 收集文件
2. 核对附件
以下操作由接收方完成。
3. 检查交付目录
4. 确认接收这样表达的是两份列表,后半段从 3 开始。它在视觉上接续,但编辑时需要自行维护这个起点:如果前半段新增一步,就应重新检查后半段是否仍该从 3 开始。保留段落前后的空行,也能让结构更容易复核。
若两组步骤应当分别从 1 开始,用真实的阶段标题划分,读者也更容易理解:
## 准备阶段
1. 收集文件
2. 核对附件
## 接收阶段
1. 检查交付目录
2. 确认接收不要只在两个 1. 之间多加空行来表达新阶段。CommonMark 允许同一列表的项目之间存在空行;空行本身不保证重新编号。对应规范可用于核对这一边界。
按现象检查,不反复试改数字
| 看到的现象 | 优先检查 | 建议处理 |
|---|---|---|
| 源码全写 1,显示连续数字 | 是否正是连续步骤 | 符合目标就保留 |
| 中间写 1,却没有重开 | 是否仍属于同一列表 | 用阶段标题明确划分新列表 |
| 插入说明后意外从 1 开始 | 说明是否到了列表外 | 按说明用途决定缩进,或设置新列表起点 |
| 代码之后编号错乱 | 代码围栏和列表项归属 | 先修复结构,再核对编号 |
| 跳跃编号被自动排连续 | 编号是否是固定业务标识 | 改用明确标签或编号字段 |
| 预览正确,成品不同 | 两处是否使用相同实现和样式 | 用同一段最小源码比较最终输出 |
交付前核对三件事
先保留原文件,单独复制出“前两项、插入内容、后一项”作为检查样本。记录预期起点、项目数量和最后一个编号,再在目标软件中核对。这里的预期来自文档用途,不应仅以源码里手写了什么数字为准。
接着检查中间的说明和代码究竟属于某一步,还是独立于整个列表。最后再看导出成品;需要交付 HTML 或 PDF 时,可按 Markdown 导出检查流程核对。只有最终阅读位置的编号、层级和内容归属都符合预期,才算完成这次文档修正。
依据与进一步阅读
试着完成自己的任务
先用一份小样本验证流程,再处理正式文件。指南免费阅读,工具的体验范围与积分价格见产品详情。
前往相关页面