如何用Pandoc将带交叉引用的LaTeX文档转换为合规Word(docx)文件

问题原因 #

你遇到的[xxx]标签异常，是由于2.16.1版本Pandoc对LaTeX的多类型交叉引用（图片、表格、公式、自定义定理环境）支持不完善，仅默认支持章节引用，其余类型的标签会直接以原始ID加方括号的形式输出。

可行解决方法 #

方案1：升级Pandoc版本（最简单） #

升级Pandoc到2.19及以上的稳定版本，新版本已内置对图片、表格、公式引用的原生解析能力，配合你原有命令中的docx+native_numbering扩展即可直接生成正确的编号与跳转链接，无需修改其他参数。

方案2：使用pandoc-crossref过滤器（支持自定义环境引用） #

如果不便升级Pandoc，可使用专门处理交叉引用的pandoc-crossref过滤器实现正确输出：

1. 安装和你当前2.16.1版本Pandoc匹配的pandoc-crossref工具
2. 调整转换命令，将--filter pandoc-crossref参数放在--citeproc之前，修改后的命令如下：

pandoc simple.tex --to docx+native_numbering --output simple.docx --filter pandoc-crossref --table-of-contents --toc-depth 5 --number-sections --citeproc --verbose --csl ieee.csl

如果需要正确识别example环境的引用，可在同级目录新建名为crossref.yaml的配置文件，内容如下：

example:
  name: "示例"
  prefix: "示例"

然后在转换命令中追加参数--metadata-file crossref.yaml即可。

方案3：临时隐藏标签（无需额外工具） #

如果你不需要保留引用的跳转功能，仅需删除异常的[xxx]标签：

• 转换完成后在Word中使用通配符查找替换，查找内容输入\[*\]，替换为空白，可批量删除所有此类标签。
• 也可以编写简单的Lua过滤器在转换过程中直接过滤掉此类标签输出。

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