本页内容
核对目标，再检查最终 Word
- 保存原始 MD 和当前编辑器草稿，检查目录文字、链接片段与对应标题。
- 先试一个目录项；如果目标不存在，不只修改显示名称。
- 按本例下载的修订 MD，将唯一 id 放到标题本身，并匹配当前预览实际生成的目标。
- 检查六处目录与两组重复标题，再导出 Word；空锚点在网页有效也不能省略这一步。
- 在实际 Word/WPS 打开成品，逐项点击目录；若需自动页码目录，另按标题样式建立并验证。
下面的 HTML 标题与 user-content- 目标写法只针对本次 Doc2X 链路；移到其他渲染器时重新检查。
同一目录的三次结果：0 → 0 → 6 个 Word 目标
将面积课、运动课两份自编 MD 上传合并工具，保留目录与脚注去重默认设置。2026-10-13 的合并下载与此前公开的 796 字节 MD 完全相同。随后在编辑器原样导出，再分别试用空锚点、标题锚点，保留三份真实 DOCX。
| 输入版本 | 网页目录目标 | Word 目录目标 | 原生脚注 |
|---|---|---|---|
| 原始合并 MD | 0 / 6 | 0 / 6 | 0 |
| 标题前空 a 锚点 | 6 / 6 | 0 / 6 | 0 |
| 标题自身 h1/h2 锚点 | 6 / 6 | 6 / 6 | 0 |
- 两份输入含同名“本课目标”“数据与公式”。合并稿保留六条目录项，第二组标题链接带 -1；不同渲染器还需验证实际目标。
- 两份脚注正文相同，合并稿共用一个定义、两处引用；网页显示一个文末条目。
- 原样 Word 有两张原生表格及两个公式对象，但六个目录链接没有对应书签。
- 把唯一 id 放到标题自身，并匹配当前编辑器的 user-content- 目标后，第三份 DOCX 六个目录目标存在。空 a 锚点版本只在网页中有目标，不能据此保证 Word。
三份 DOCX 都是真实下载字节，未改写内部结构；均有两张原生表格和两个 Office 数学对象。本次检查了网页目标、DOCX 目录书签与脚注结构，未在桌面 Word/WPS 打开或点击目录。脚注仍是文末普通条目，两个返回正文链接仍缺目标，也没有自动页码目录域；本例不含图片或长文分页。
先了解这几件事
目录文字可见不代表链接有目标。本例原始六条目录在网页和 Word 都缺少匹配目标；空 a 锚点仅解决网页目标。把唯一 id 放在 h1/h2 标题本身，并匹配本次编辑器生成的 user-content- 前缀后，实际 DOCX 的六条目录链接都有对应书签。此结果是文件结构核对，桌面 Word 点击仍需验证。
- 原样导出
- 六条目录、零个匹配目标。
- 空锚点试验
- 网页六个目标存在；Word 仍为零。
- 标题锚点试验
- 网页与 DOCX 六个目录目标均存在。
- 未解决
- 原生脚注、脚注返回链接、自动页码目录与桌面交互验收。
本例最终导出的标题与链接写法
第一课：标题 id 与实际目标分开写清
- [面积课笔记](#user-content-lesson-area)
- [本课目标](#user-content-area-goal)
<h1 id="lesson-area">面积课笔记</h1>
<h2 id="area-goal">本课目标</h2>本次编辑器预览为 id 加上 user-content- 前缀，实际 Word 也保留了该标题目标。本写法已在下载样例验证，其他编辑器不一定采用同样规则。
第二课：同名标题使用不同目标
- [运动课笔记](#user-content-lesson-motion)
- [本课目标](#user-content-motion-goal)
<h1 id="lesson-motion">运动课笔记</h1>
<h2 id="motion-goal">本课目标</h2>显示文字仍可同名，目标必须唯一。这里不是对任意 Markdown 自动目录规则的保证。
按哪一层出了问题选择下一步
| 观察 | 本例原因或边界 | 下一步 |
|---|---|---|
| 目录文字存在，点击无对应位置 | 源链接与渲染后的标题目标不同 | 确认目标实际存在，不只检查链接文字 |
| 网页目标存在，Word 没有 | 空 a 锚点未进入本次 DOCX | 用本例标题锚点方案，再核对导出文件 |
| 脚注文字在文末 | 没有原生 Word 脚注对象 | 按最终文稿要求在目标软件另行处理 |
| 想自动更新目录页码 | 本例是静态链接目录 | 在 Word 中按标题样式建立并验证自动目录 |
目录列表、标题目标、自动目录是三件事
Markdown 链接列表只记录目标字符串。本次 Word 文件里有标题书签，却没有自动页码目录域。需要自动页码或修改后更新页码时，仍要在目标文字处理软件建立符合要求的目录。
为什么空锚点只通过网页检查
第二次输入把空 a 元素放在标题前，网页已有六个匹配目标，DOCX 却没有保留这些独立目标。第三次把 id 放到标题自身后，六个书签才与目录链接匹配。保留三份实际文件，避免把失败尝试写成成功方案。
标题相同，目标不能相同
本例两课都有“本课目标”和“数据与公式”。最终分别使用 area-goal、area-data、motion-goal、motion-data，目录按当前渲染前缀指向不同标题。仅靠显示标题或加 -1 字符，无法保证另一个渲染器的目标存在。
不能把这套前缀当成通用语法
user-content- 是本次编辑器实际生成的目标前缀；已有 HTML id 输入和源链接需要配套。换到 GitHub、其他编辑器或不同转换器后，先查看实际目标再使用，不机械对全文追加前缀。
脚注返回不是目录修订的一部分
最终 DOCX 六条目录目标已经匹配，但脚注仍是普通文末条目，两个返回正文链接仍没有书签。不要据此宣称全文内部链接都已修复；关键交付要求应逐类检查。
相关官方说明
遇到这些情况
- 标题看得到，目录没有目标
- 核对真实目标 id 或文档书签是否存在，不只检查标题文字。
- 网页正常，Word 仍没有目标
- 本例空 a 锚点即如此；下载实际 DOCX 并在目标软件核对。
- 第二个“本课目标”定位错课
- 为同名标题使用不同目标，逐项检查两课位置。
- 目录没有页码或不能自动更新
- 本例是静态链接列表，没有自动目录域。
常见问题
原始合并目录的 -1 后缀一定有效吗？
不一定。本例合并稿生成了 -1 后缀，但目标编辑器并未生成对应标题目标，需要在实际环境核对。
现在可以保证在所有 Word/WPS 里点击正常吗？
不能。本次已核对 DOCX 六条目录均有对应书签，尚未做桌面 Word/WPS 点击验收。请用下载文件在交付环境验证。
修好目录也会修好脚注吗？
不会。本例没有原生 Word 脚注，两个脚注返回目标仍缺失；目录和脚注要分别检查。
内容核对：2026-10-13 · 功能条件与配额以当前产品界面为准