DOC2X使用指南

Markdown 合并:脚注编号与重复标题

多份 MD 合并后检查同名脚注、链接定义、重复标题和目录跳转。脚注标识相同不代表内容相同;保留源码定义和引用关系,在最终渲染器核对显示编号。

你的文件
含脚注、引用链接与标题的 MD 文件
得到什么
保留引用关系的合并 Markdown
操作流程示意

Markdown 合并:脚注编号与重复标题

01

比较同名定义

02

合并并检查目录

03

核对渲染后的引用

操作流程示意 · 在工具中处理自己的文件后,再核对实际结果

本页内容

比较同名定义,再完成后续处理

  1. 上传文件并确定顺序,查看脚注和链接是否重名。
  2. 按需要选择目录、脚注去重与引用处理设置,重新合并。
  3. 下载 MD,比较定义、正文引用和重复标题锚点。
  4. 在最终渲染器逐个点击脚注与目录,保留输入文件。
上传 Markdown,检查引用合并

在最终渲染器逐个点击脚注与目录,保留输入文件。

两份自编讲义,下载实际合并结果

2026 年 10 月 9 日,将面积课和运动课两份自编 Markdown 上传到已上线的合并工具。使用默认分隔符、目录和脚注去重设置,下载未经改写的合并 MD;可连同两份输入一起核对。

实际下载文件中的目录与脚注(节选)

## 目录

- [面积课笔记](#面积课笔记)
  - [本课目标](#本课目标)
  - [数据与公式](#数据与公式)
- [运动课笔记](#运动课笔记)
  - [本课目标](#本课目标-1)
  - [数据与公式](#数据与公式-1)


[^area]: 本段为手工编写的工具测试材料,不是识别或翻译输出。
  1. 两课都包含“本课目标”和“数据与公式”,第二组目录锚点带 -1,中文目标不是空的 #。
  2. 两份输入的脚注内容相同,合并后保留一个定义,正文引用均对应这条定义。
  3. 表格数据、公式源码与文件顺序可以直接对照输入;最后仍需在自己的 Markdown 渲染器检查。

这是手工编写输入的真实工具输出,不是 OCR 或翻译结果。本例没有图片资源、嵌套脚注或复杂 HTML;它不能代表这些内容已完成验证。不同内容的同名脚注另由自动化回归测试检查。

先了解这几件事

各文件都使用 [^1] 时,合并后必须区分它们的定义。工具会处理跨文件的标识冲突;启用脚注去重时,相同内容可共用定义,不同内容保留各自引用。目录使用标题锚点,重复标题的目标也需区分;最终显示编号仍由 Markdown 渲染器决定。

输入
含脚注、引用链接与标题的 MD 文件
输出
保留引用关系的合并 Markdown
核对重点
比较同名定义 → 合并并检查目录 → 核对渲染后的引用

标识相同与内容相同分开判断

脚注源码中的标签是引用标识,阅读时显示的序号可由渲染器重排。两个 [^1] 内容不同不能当成一条脚注;同一段内容使用不同标签时才可能合并定义。

普通链接与脚注不是一种语法

普通引用链接使用 [文本][标签] 与链接定义,脚注使用 [^标签]。核对合并输出时应分别检查,避免脚注定义被改成普通链接,或正文文字意外消失。

中文目录与重复标题逐个点开

自动目录应有实际目标,中文标题不能只留下空的 #。同名章节需要不同锚点;目标工具的标题锚点规则可能不同,发布或导出后重新测试跳转。

代码与公式保持原义

代码围栏里的 #、链接样例和公式字符不应被当成正文标题或引用重新编号。对包含代码示例、嵌套脚注或复杂定义的文稿,先用一个短片段验证,再处理全文。

详细操作教程

常见问题

合并后脚注编号改变是错误吗?

不一定。显示序号可重新排列,关键是每个引用仍指向正确内容。

中文目录可以直接在所有平台通用吗?

不能保证。目标渲染器可能使用不同锚点规则,需要在最终环境验证。

内容核对:2026-10-09 · 功能条件与配额以当前产品界面为准