Quarto渲染PDF时图片位置异常问题求助

Quarto渲染HTML文档时，所有图片能严格按照.qmd文件里的编写位置，正确显示在对应文本段落之间；但渲染PDF时图片位置会错乱——多数集中在文档末尾，虽然顺序正确，但和文本的对应位置完全不符。这个问题可以通过修改YAML配置来解决。

你的当前YAML配置：

title: "my doc title"
author: "my name"
date: last-modified
date-format: iso
execute:
  echo: false
  warning: false
format: 
  pdf: 
    number-sections: true

修改后的YAML配置（添加图片位置控制参数）：

title: "my doc title"
author: "my name"
date: last-modified
date-format: iso
execute:
  echo: false
  warning: false
format: 
  pdf: 
    number-sections: true
    fig-pos: "h"
    fig-cap-location: "bottom"

配置说明 #

• fig-pos: "h"：强制LaTeX将图片尽量放在定义它的文本位置（"h"即here），这会覆盖LaTeX默认的自动排版逻辑（默认会把图片挤到空白较多的位置，比如文档末尾）。
• 如果"h"的强制效果不够理想，可以尝试组合参数fig-pos: "htbp"，优先级依次是：当前位置→页面顶部→页面底部→单独一页。

额外调整方案 #

如果全局配置后仍有个别图片位置不对，可以给单个图片单独指定位置：

• 代码块插入的图片，在代码块属性里加fig.pos='h'：

knitr::include_graphics("your-image-path.png")

• Markdown原生语法插入的图片，添加属性：

![图片描述](your-image-path.png){fig.pos="h"}

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