Quarto生成PDF时如何实现图片无间隙铺满页面宽度？

核心解决方案：直接锚定页面边界 #

避免使用自带内边距的figure环境，改用\AddToShipoutPicture*直接将图片定位到页面左上角，完全覆盖边距区域：

\AddToShipoutPicture*{%
  \AtPageUpperLeft{%
    \raisebox{-\height}{\includegraphics[width=\paperwidth]{../images/titlestrip.png}}%
  }%
}

代码说明：

• \AddToShipoutPicture*：仅对当前首页生效，不会影响后续页面
• \AtPageUpperLeft：将图片左上角精准对齐页面左上角边界
• \raisebox{-\height}：默认图片顶边贴合页面上边，此命令让图片整体向下移动自身高度，确保底边也贴合页面（若你的图片仅需横向铺满、纵向无需覆盖全页，可换成固定值，比如\raisebox{-8.38cm}对应你的原图高度）
• width=\paperwidth：强制图片宽度等于页面实际宽度，彻底消除两侧间隙

按需裁剪图片 #

若原图比例与页面宽度不匹配，可添加trim和clip参数裁剪冗余区域：

\AddToShipoutPicture*{%
  \AtPageUpperLeft{%
    \raisebox{-\height}{\includegraphics[width=\paperwidth, trim=1cm 0 1cm 0, clip]{../images/titlestrip.png}}%
  }%
}

• trim=左 下 右 上：按顺序裁剪图片对应方向的区域，单位支持cm、in等
• clip：启用裁剪功能，让超出指定范围的部分被隐藏

此前方法无效的原因 #

• figure环境自带默认内边距和浮动特性，嵌套adjustwidth也难以完全抵消边距
• 手动设置固定宽度（如23cm）可能和实际页面宽度存在误差，导致细微白边
• textblock*依赖精确坐标计算，稍有偏差就会出现间隙

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