Pandoc 3.2.1生成EPUB出现重复Footnote ID问题求助

排查重复ID问题的步骤 #

• 导出EPUB对应的HTML源码，直接查看脚注ID情况：执行命令 pandoc 你的输入文件.md -t html -o footnotes-debug.html，在生成的HTML里搜索fnref13这类重复ID，定位对应的脚注内容。
• 检查Markdown文档中的内联脚注，是否存在内容完全一致的多个内联脚注？Pandoc对相同内容的内联脚注可能生成重复ID。
• 拆分Markdown文件，分块进行转换测试，逐步定位引发问题的具体段落或脚注。

获取Pandoc更多运行信息的方法 #

• 添加--verbose参数运行转换命令，会输出转换过程的详细日志，包括脚注ID生成的相关细节：pandoc 你的输入文件.md -o 输出文件.epub --verbose
• 设置环境变量PANDOC_DEBUG=1后再执行转换命令，能获取更底层的内部处理日志。

临时修复方案 #

• 给触发问题的内联脚注手动指定唯一ID，格式为[^自定义唯一ID]: 脚注内容，强制Pandoc使用自定义ID避免重复。
• 升级Pandoc到最新稳定版本，该重复ID问题可能是v3.2.1的特定bug，新版本大概率已修复。

内容的提问来源于stack exchange，提问作者tridral