使用Pandoc转Markdown为PDF：强制图片随文本及错位问题求助

我之前把Markdown文档转PDF时也碰到过一模一样的图片排版坑，给你几个亲测有效的解决方案，帮你把图片牢牢钉在对应的文本旁边：

1. 强制图片固定在文本位置（最有效） #

Pandoc转PDF默认用LaTeX引擎，LaTeX的浮动机制经常会把图片挪到后面页面。要强制图片待在原地，你需要：

• 首先在Pandoc命令里导入LaTeX的float包，它提供了强制固定位置的参数：

  pandoc -s --include-in-header='\usepackage{float}' FirstSection.md OtherSections.md -o manual.pdf
  

• 然后在Markdown的图片标记后添加{float=H}属性（H代表Here，就是当前位置），还可以顺便调整图片尺寸：

  ![软件配置界面截图](config-ui.png){float=H width=85%}
  

  这样图片就会严格出现在你写它的文本位置，不会乱跑了。

2. 调整图片尺寸避免页面溢出 #

很多时候图片被挤到后面，是因为当前页面剩余空间放不下整张图。你可以给图片设置相对页面的宽度，确保它能塞进当前页面：

![数据统计仪表盘](dashboard.png){float=H width=90%}

或者设置固定高度：

![复杂架构图](architecture.png){float=H height=12cm}

3. 优化多章节文档的分页逻辑 #

如果你的GitHub Wiki是分多个章节的，加上--top-level-division=chapter参数可以让章节分页更合理，减少图片被跨页挤压的情况：

pandoc -s --top-level-division=chapter --include-in-header='\usepackage{float}' *.md -o manual.pdf

4. 手动插入分页符（应急方案） #

如果某个图片实在太大，当前页面塞不下，你可以在图片前手动插入LaTeX分页命令，让图片在新页面开头显示：

\newpage
![超大功能演示图](big-demo.png){width=100%}

这些方法组合起来，基本能解决90%以上的图片排版问题，你可以先试试第一个方案，应该就能搞定大部分情况~

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