使用pandoc处理EPUB文件时遇“not found in reftable”错误求助

问题背景 #

使用Pandoc合并或转换EPUB文件时，反复触发not found in reftable错误，推测是EPUB内部特殊样式/引用结构导致，但ebook-convert可正常处理，需保留Pandoc完成批量合并需求。执行的错误命令包括：

pandoc (get-item *.epub).FullName -o output.epub
pandoc -f epub -t plain --wrap none -o filename.txt filename.epub

可行解决方案 #

1. 用Calibre修复EPUB结构后再处理 #

利用ebook-convert将原EPUB转成标准结构的EPUB，修复引用表问题，再用Pandoc操作：

• 单文件修复：

  ebook-convert input.epub fixed_input.epub
  

• 批量修复+合并的PowerShell脚本：

  # 批量生成修复后的EPUB文件
  Get-ChildItem *.epub | ForEach-Object {
      ebook-convert $_.FullName "fixed_$($_.Name)"
  }
  # 用Pandoc合并修复后的文件
  pandoc fixed_*.epub -o merged_output.epub
  # 可选：清理临时修复文件
  Remove-Item fixed_*.epub
  

2. 明确指定EPUB版本解析 #

部分EPUB可能采用特定版本规范，Pandoc默认解析逻辑不兼容，尝试指定输入格式为epub2或epub3：

# 合并时指定EPUB3格式
pandoc --from epub3 *.epub -o output.epub
# 转TXT时指定版本
pandoc --from epub2 -t plain --wrap none -o filename.txt filename.epub

3. 转成Markdown后再合并 #

若上述方法无效，先将EPUB转成Markdown格式，再用Pandoc合并并输出目标格式：

• 批量转Markdown：

  Get-ChildItem *.epub | ForEach-Object {
      ebook-convert $_.FullName "$($_.BaseName).md"
  }
  

• 合并Markdown并输出EPUB：

  pandoc *.md -o final_output.epub
  

4. 用epubcheck检查并修复EPUB #

使用epubcheck工具扫描EPUB文件的结构错误，定位具体的引用表问题，手动或自动修复后再用Pandoc处理：

# 扫描单个EPUB
epubcheck input.epub

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