如何用Pandoc实现跨Markdown文件章节链接并兼容多输出场景？

当然有办法搞定！你完全可以用一套Markdown文件，靠Pandoc的元数据变量和统一锚点技巧，同时适配合并成单HTML和生成多独立HTML两种场景，不用维护多份输入文件。下面一步步给你讲怎么实现：

1. 给章节加唯一锚点 #

先在两个Markdown文件里，给需要互相跳转的章节加上唯一的锚点标签——这是跨场景链接的基础：

• 在file1.md里：

  ## 第一章：入门 {#chapter-intro}
  

• 在file2.md里：

  ## 第二章：进阶 {#chapter-advanced}
  

锚点名称要保证全局唯一，别让不同章节重名，不然跳转就乱了。

2. 用变量写跨文件链接 #

在链接其他文件的章节时，别直接写死路径，而是用Pandoc的元数据变量当前缀，比如：

• 在file1.md里链接file2的进阶章节：

  想要深入了解？去看[第二章：进阶]({$file2}#chapter-advanced)
  

• 在file2.md里链接file1的入门章节：

  还没入门的话，先读[第一章：入门]({$file1}#chapter-intro)
  

这里的{$file1}和{$file2}是我们自定义的变量，编译时会根据场景被替换成对应内容。

3. 两种场景的编译命令 #

场景1：合并成单个HTML #

编译时把变量设为空字符串，这样链接就自动变成单文件内的锚点跳转：

pandoc file1.md file2.md -o combined.html --variable file1="" --variable file2=""

生成的combined.html里，链接会变成#chapter-advanced，完全符合单文件内的跳转逻辑。

场景2：生成独立HTML文件 #

分别编译每个文件时，把变量设为对应HTML的文件名：

# 编译file1.html，指定file2的链接目标是file2.html
pandoc file1.md -o file1.html --variable file1="file1.html" --variable file2="file2.html"

# 编译file2.html，指定file1的链接目标是file1.html
pandoc file2.md -o file2.html --variable file1="file1.html" --variable file2="file2.html"

这时候生成的独立HTML里，链接会变成file2.html#chapter-advanced，跨文件跳转完全正常。

进阶小技巧：用元数据文件统一管理变量 #

如果觉得每次写--variable太麻烦，可以把变量存到YAML元数据文件里：

• 新建vars-combined.yaml（用于合并编译）：

  file1: ""
  file2: ""
  

• 新建vars-separate.yaml（用于独立编译）：

  file1: "file1.html"
  file2: "file2.html"
  

然后编译时直接导入对应的文件就行：

# 合并成单HTML
pandoc file1.md file2.md -o combined.html --metadata-file vars-combined.yaml

# 生成独立HTML
pandoc file1.md -o file1.html --metadata-file vars-separate.yaml
pandoc file2.md -o file2.html --metadata-file vars-separate.yaml

这样主Markdown文件完全不用改，换个元数据文件就切换场景，超省心。

最后提醒一下 #

• 锚点一定要唯一，哪怕章节标题一样，锚点也得区分开，比如#ch1-intro、#ch2-intro。
• 如果文件数量多，变量可以按规律命名，比如{$ch1}、{$ch2}，管理起来更顺手。

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