Zettlr中LaTeX导出图片比例问题的分析与解决

问题描述

在使用Zettlr进行Markdown文档导出为LaTeX/PDF时，发现当仅指定图片宽度百分比时，图片高度会被错误地设置为100%页面高度，而非保持原始宽高比。这导致图片出现明显的拉伸变形现象。

技术背景

Zettlr是一个基于Markdown的写作工具，它通过Pandoc将Markdown转换为各种输出格式。在LaTeX导出过程中，图片尺寸控制是一个常见需求，通常通过Markdown图片属性中的width和height参数来实现。

问题复现

当使用如下Markdown语法指定图片宽度百分比时：

![图片描述](image.png){#fig:example width=70%}

生成的LaTeX代码会错误地包含高度设置：

\includegraphics[width=0.7\textwidth,height=\textheight]{image.png}

问题根源

经过测试发现，该问题并非Zettlr核心功能导致，而是与用户自定义的LaTeX模板有关。当使用默认导出配置时，图片比例能正确保持。这表明问题出在模板中对图片处理的特殊设置。

解决方案

1. 临时解决方案：在导出配置中仅保留基本读写器设置，不使用自定义模板
2. 长期解决方案：检查并修改自定义LaTeX模板中的图片处理部分

技术建议

对于需要自定义LaTeX模板的用户，建议：

1. 避免在模板中重写图片处理逻辑
2. 如需特殊图片处理，应明确测试各种尺寸设置情况
3. 保持模板简洁，只包含必要的样式修改

总结

Zettlr的LaTeX导出功能本身能正确处理图片比例，但当使用自定义模板时需要特别注意图片尺寸控制逻辑。开发者应确保模板不会干扰Pandoc的正常图片处理流程，以保持图片显示的准确性。