Markdown拆分后链接和脚注失效？补齐引用定义再核对

本页内容

拆分之后，逐章带全它需要的定义

保留原始MD，先选真实章节层级。本例用H2，保留Frontmatter，点击开始拆分后全选并下载ZIP。
解压后分别打开每章源码，查找正文使用的引用标签，以及对应的链接、图片或脚注定义是否仍在当前文件。
若定义在另一章，在副本末尾补入需要的完整定义。本例复制catalog、scan两个链接定义和review脚注，保留脚注续段的四空格缩进。
检查脚注正文是否又引用其他标签；代码围栏里的相似文本不是有效定义。不要只复制脚注第一行。
将修复副本在目标编辑器或工具中重新打开，核对链接目标、脚注编号、跳转和返回；本例在拆分工具中验证后另行导出。
保留修复前后的文件，按实际内容确认完成。图片文件、跨文件锚点和其他编辑器兼容性另行检查。

打开Markdown拆分，选择MD文件

本例在本地编辑第一章副本，再选入同一工具预览和导出。拆分工具不会自动补引用；保留Frontmatter只控制文件头。

同一章：原生分片缺定义，补齐副本后可跳转

一份完全自编的中文笔记，实际按H2拆分并下载ZIP。左图是原生第一章在工具中的预览；右图是本地追加定义的副本重新选入工具后的实际预览。没有改写原生ZIP或分片，修复副本不是自动处理结果。

真实第一章预览，功能目录和扫描流程显示为带catalog和scan的引用文本，review脚注也未转为编号 — 原生第一章：引用仍是方括号文本

同一工具打开636字节本地修复副本，两个正文链接可点击，脚注1、脚注内目录链接和返回箭头可见 — 本地补定义，再打开：链接和脚注出现

保留全文和每章独立可用，是两项检查
文件	本次核对	含义
原稿792字节	整份用本次GFM解析器解释，引用能找到末尾定义	工具自己的分段预览仍有作用域限制
原生第一章373字节	无实际链接或脚注定义，代码内的catalog行不算	独立解释时无法解析正文两个链接和脚注
原生第二章419字节	保存catalog、scan及完整review定义	两章连接与原稿逐字节相同
本地修复副本636字节	第一章内容未改，只追加换行及完整定义	重新打开后链接、脚注及返回箭头可用
修复副本经浏览器导出636字节	与本地修复副本逐字节相同	不是原生拆分器自动补齐的结果

复制的是完整定义，包含脚注内引用与缩进续段

[catalog]: https://www.noedgeai.com/features/ "功能目录"
[scan]: https://doc2x.noedgeai.com/help/zh-cn/tutorials/scan-workflow.html "扫描工作流"

[^review]: 合计只用于本练习，不是业务数据。
    复核方法见[功能目录][catalog]。

实际两章ZIP里只有两份MD；连接后还原原稿，不等于每份引用依赖已自足。
第一章中的数量12、28、20及合计60、代码和末尾标记原样保留；修复不需要重写正文。
本地副本追加两个链接定义与一段多行脚注。代码围栏内的[catalog]:保持代码，不把它当成链接来源。
重新打开后实际点击脚注1和返回箭头，地址片段分别定位review与fnref-review；两个正文链接和脚注内的目录链接也已显示。
原生ZIP与两个成员保持原字节；浏览器另导出的修复副本与本地编辑件相同。

本次只验证两个引用标签和一个脚注。工具预览按标题分段，完整原稿的跨段定义也没有在前段显示，所以需要结合下载源码与整份解析核对。未测试图片打包、跨文件锚点、嵌套脚注、重复定义或任意编辑器兼容性，不承诺自动修复。

下载含跨章定义的自编原稿下载实际H2两章ZIP（未修改）查看原生第一章（缺定义）查看原生第二章（定义在这里）下载本地修复副本的实际导出MD 下载原稿、原生结果与追加内容核对包阅读本次操作与预览限制

先了解这几件事

先打开拆好的MD源码，检查[文字][标签]和[^脚注]是否在同一份文件中有定义。定义若留在另一章，复制完整定义到需要它的章节副本；脚注的缩进续段和其中用到的链接也要带全。然后在目标编辑器核对真实链接和脚注往返。本例两章接回去与原稿字节相同，却不代表每章独立可用；工具分段预览的限制也要与下载内容分开判断。

原稿与原生ZIP: 792字节原稿按H2拆出373和419字节两章；ZIP为1,234字节。
独立第一章: 正文、数字和代码都在，两个链接定义和一个脚注定义却在第二章。
修复副本: 本地只追加完整定义，636字节；重新打开并导出的字节保持。
预览边界: 工具按标题分段渲染，原稿跨段定义也可能不显示，不凭预览判断原文件损坏。

先分清缺的是定义、文件还是预览支持

先分清缺的是定义、文件还是预览支持
现象	先看哪里	处理方式
[文字][标签]没有变成链接	当前MD是否有同标签的有效定义	在副本补入对应定义，核对URL
[^编号]仍是普通文字	当前MD是否有完整脚注定义，编辑器是否支持脚注	带全缩进续段，在目标环境验证
代码里有同名定义，正文仍失效	定义是否在反引号围栏里	代码保持代码，从实际定义处取内容
整份源码有定义，工具预览仍不显示	预览是否分段解释	与下载源码分开检查，不直接认定文件已损坏
图片文件或跨章跳转失效	相对目录、目标文件和锚点规则	另行带齐资源并在目标阅读器逐个核对

一个文件里的定义，不会跨文件自动共享

引用式链接把正文的[功能目录][catalog]与[catalog]: URL分开写。同一文档中，定义可以写在引用之前或之后；分成两份MD后，阅读器通常只解释当前文档，不会自动去第二章寻找定义。完整原文保存与每份结果独立可读需要分别核对。

脚注要带整个块，里面的链接也要看

本例review有首行说明和缩进续段，续段又使用catalog标签。只复制[^review]:一行会漏掉后续复核方法；只带脚注却不带catalog定义，脚注里的引用也可能失效。按实际依赖整理，不把纯文本搜索当作通用自动收集。

保留Frontmatter，不等于保留引用上下文

Frontmatter是文档开头的YAML元数据。本例开启后只留在第一章，不会把位于第二章末尾的链接和脚注定义移过来。不要靠反复切换开关或更改长度目标修复引用。

预览和下载内容，按各自范围核对

本工具将标题段落分别渲染。完整原稿在分段预览中也未显示跨段链接，而本次整份GFM解析能找到定义。实际第一章下载则确实没有定义。先查源码，再用目标阅读器解释；这两项结果可能不同。

修复后再合并，避免同名定义冲突

分章副本为了独立阅读可能重复保存同一个定义。之后合并时，先确认同名标签是否仍对应同一URL和脚注含义；不同内容不要机械覆盖。CommonMark遇到多个匹配的链接定义采用第一项，不能只看最后追加的那一行。

遇到这些情况

补了定义，仍没有链接: 检查空行、冒号与缩进，确认定义不在代码围栏中；再核对标签和目标编辑器支持。
脚注编号出现，说明却不完整: 把原脚注的缩进续段和其中依赖的标签一并核对。
在工具中正常，另一个软件仍不同: 脚注和标题锚点支持可能不同，在真正要使用的阅读器检查。
全文接回去了，每章还是不能独立读: 字节还原检查的是全文保留；逐章还需要自己的定义与资源。

常见问题

Markdown拆分后链接失效，是正文被删除了吗？

不一定。本例两章连接能逐字节还原原稿，第一章正文也在；失效来自定义留在第二章。先查当前文件引用标签和定义，再判断是否确实缺正文。

MD拆分后脚注不显示怎么办？

在每章副本补齐所需脚注定义，包括缩进续段和里面引用的其他标签；确认目标阅读器支持脚注，再检查编号、跳转与返回。

拆分工具会自动补齐跨章链接和脚注吗？

本次工具没有自动补齐。页面提供的修复文件是本地编辑副本，重新打开并导出的字节保持，不是自动修复功能。

原稿里有定义，为什么预览也没有链接？

本工具按标题分段渲染，跨段定义可能不在当前预览段的作用域里。下载源码与目标阅读器的整份解释应单独核对，不直接把预览差异当成原稿损坏。

保留YAML能让每一章的脚注都正常吗？

不能。YAML文件头与链接、脚注定义不同；本例保留Frontmatter没有自动复制第二章里的定义。

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

Markdown拆分后链接和脚注失效