Pandoc不同PDF引擎的垂直间距差异分析

在文档转换工具Pandoc的使用过程中，开发者们经常需要选择不同的PDF引擎来生成最终输出。本文深入探讨了Pandoc支持的三种主流PDF引擎（pdflatex、typst和pdfroff）在处理文档垂直间距时的差异表现，特别是标题与正文之间的间距问题。

核心差异表现

通过对比测试发现，三种引擎在垂直间距处理上存在显著差异：

1. pdflatex表现最为一致，标题与各种后续内容（普通文本、列表、注释块）之间的间距保持相同
2. pdfroff和typst在处理标题与注释块之间的间距时，会比其他内容类型增加近一倍的距离
3. typst引擎的默认设置中，标题与正文的间距明显小于其他引擎，这在视觉上可能显得过于紧凑

技术原因分析

这种差异源于各引擎的设计理念和默认样式设置：

• pdflatex遵循LaTeX的传统排版规则，强调一致性
• pdfroff基于groff系统，继承自传统的UNIX文档工具链
• typst作为新兴引擎，采用了更现代的间距处理方式

特别值得注意的是，typst文档明确说明其设计意图：当段落与非段落块相邻时，会优先考虑块的上下间距属性。标题元素默认会减少下方间距以获得更好的视觉效果。

解决方案与建议

对于需要调整typst间距的用户，可以通过以下方式实现：

1. 直接修改模板：导出默认的typst模板后，添加特定的间距设置规则
2. 使用header-includes：通过Pandoc的元数据功能注入调整代码，无需直接编辑模板
3. 特定代码调整：在文档中添加#show heading: set block(below: 1em)这样的指令

设计哲学思考

Pandoc项目维护者明确指出，保持不同引擎输出的一致性并非项目目标。相反，Pandoc更倾向于让每个引擎输出符合其自身设计理念的"地道"结果。这种设计哲学允许用户根据需求选择最适合的引擎，而不是被强制统一的行为所限制。

对于追求特定视觉效果的用户，建议通过自定义模板或后处理来实现目标，而不是期望Pandoc改变其跨引擎兼容性策略。这种灵活性正是Pandoc强大功能的体现，尽管它可能需要用户投入更多时间来微调输出结果。