使用Pandoc将Markdown转PDF时图片位置不符的技术求助

这个问题我之前帮好几个开发者捋清楚过，本质上是LaTeX的浮动排版机制在搞鬼——它会自动把大元素挪到它认为“合适”的位置，但很多时候这反而破坏了我们想要的排版逻辑。下面给你几个实用的解决方案，从简单到进阶都有：

1. 直接给图片加强制固定位置的属性 #

Pandoc支持在Markdown图片语法里嵌入LaTeX的浮动控制参数，其中最有用的就是float=H（需要依赖LaTeX的float包），它能强制图片留在源码指定的位置。

步骤： #

• 先在你的Markdown文档开头添加LaTeX包引用（用原生LaTeX块）：

  \usepackage{float}
  

• 然后在图片语法里加上float=H属性，还可以顺便调整大小：

  ![示例占位图](placeholder.png){width=80% float=H}
  

2. 缩小图片尺寸适配页面 #

如果图片本身太大是根源，那直接调整尺寸让它能放进当前页面剩余空间就好。你可以用百分比或者具体单位来控制：

# 适配宽度的写法
![示例占位图](placeholder.png){width=75%}

# 适配高度的写法
![示例占位图](placeholder.png){height=8cm}

这样LaTeX就没有理由把图片挪走了，因为它完全能放进当前页面的可用空间里。

3. 用LaTeX容器强制固定位置 #

如果不想依赖float包，你可以直接用LaTeX的minipage环境把图片包起来，彻底绕过浮动机制。在Markdown里直接嵌入这段原生LaTeX代码就行：

\begin{minipage}{\linewidth}
\centering
\includegraphics[width=80%]{placeholder.png}
\caption{这是我的示例图片}
\end{minipage}

只要图片高度不超过当前页面的剩余高度，它就会老老实实待在你放的位置。

4. 全局设置默认图片位置 #

如果你经常需要处理这类文档，可以在Pandoc命令行里直接全局配置，让所有图片默认强制固定位置：

pandoc input.md -o output.pdf --include-in-header=<(echo '\usepackage{float}') --variable=figure-placement:H

这个命令会自动给所有生成的图片容器加上[H]参数，不用再逐个修改图片语法。

注意事项： #

• 如果图片实在太大（比如高度超过当前页面剩余空间），即使加了float=H，LaTeX还是会把它挪到下一页——这时候要么缩小图片，要么在图片前手动加\newpage强制分页。
• 以上方法对常用的PDF引擎（xelatex、lualatex、pdflatex）都适用，不用额外更换引擎。

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