Quarto PDF子图标题边距调整：解决子图标题无间距重叠问题

问题描述 #

使用Quarto渲染PDF文档时，多列布局的子图如果标题内容较长，会出现子图标题互相挤压重叠的情况。尝试用\captionsetup{width=0.9\textwidth}调整标题宽度，发现该命令仅对主图标题生效，无法改变子图标题的显示范围，重叠问题依然存在。

解决方案 #

问题核心在于\captionsetup默认作用于主图（figure）的标题，需要明确指定参数将设置应用到子图（subfigure）上，以下是两种可行方法：

方法1：全局配置（YAML头部） #

在PDF格式设置中添加LaTeX头部命令，全局统一设置子图标题宽度：

---
title: "长副标题子图测试"
format:
  pdf:
    documentclass: article 
    papersize: letter
    geometry:
      - top=1.75in
      - bottom=1.75in
      - left=1.75in
      - right=1.75in
    include-in-header:
      text: |
        \captionsetup[subfigure]{width=0.9\linewidth}
        \captionsetup{width=0.9\textwidth}
  html:
    theme: default
---

方法2：局部设置（文档内） #

在子图块前添加针对性的LaTeX命令，仅对当前子图生效：

\captionsetup[subfigure]{width=0.9\linewidth}

修改后的完整示例代码 #

---
title: "长副标题子图测试"
format:
  pdf:
    documentclass: article 
    papersize: letter
    geometry:
      - top=1.75in
      - bottom=1.75in
      - left=1.75in
      - right=1.75in
    include-in-header:
      text: |
        \captionsetup[subfigure]{width=0.9\linewidth}
        \captionsetup{width=0.9\textwidth}
  html:
    theme: default
---

```{r include=FALSE, echo=FALSE, message=FALSE}
# 生成测试图片
png("DummyFigure.png")
plot( c(0,1) , c(0,10) , xlim=c(0,1) , ylim=c(0,10) , type="b" )
dev.off()

::: {#fig-TheFigure layout-nrow="1" layout-ncol="2"}
{#fig-panelA width="200px"}

{#fig-panelB width="200px"}

主图标题：Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
:::

文档正文：@fig-TheFigure展示了两个带长标题的子图及下方的主标题。添加[subfigure]参数后，子图标题会自动换行并保持合适间距，不再重叠。之前的命令仅作用于主标题，现在通过指定参数实现了对子图标题的宽度控制。Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

## 原理说明
Quarto渲染PDF时依赖LaTeX的`subcaption`包处理子图布局，`\captionsetup`通过`[subfigure]`参数，将宽度限制规则定向应用到所有子图标题，让长标题自动换行，避免相邻子图标题互相挤压。

内容的提问来源于stack exchange，提问作者John K. Kruschke