办公文档 · 实用教程

Markdown有序列表为什么不按手写数字显示:起始编号、续接与重开怎么检查

源码写1、1、1却显示1、2、3,插入说明后编号又重置?用短示例检查Markdown列表的起始数字、段落和代码块归属,以及独立列表的重新编号。

AI Lab 内容维护 · 更新于 · 约7分钟阅读

先看结论

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 导出检查流程核对。只有最终阅读位置的编号、层级和内容归属都符合预期,才算完成这次文档修正。

依据与进一步阅读

外部资料用于说明格式与语法,本站步骤与限制以当前产品实现为准,不代表第三方背书。

试着完成自己的任务

先用一份小样本验证流程,再处理正式文件。指南免费阅读,工具的体验范围与积分价格见产品详情。

前往相关页面

本文由AI辅助整理,并对照本站实现核对。例子用于说明操作,不代表所有设备与文件都已实测。反馈内容问题