如何在Quarto中用表格列表与图表列表引用代码块输出

一、动态生成表格（gt/gtsummary/flextable）自动纳入表格列表 #

默认情况下，gt、gtsummary、flextable这类包生成的动态表格不会自动被Quarto识别并加入表格列表，通过代码块参数配置即可实现：

• 在生成表格的代码块中添加 tbl-cap（表格标题）和 tbl-label（表格标签）参数，部分表格包需显式指定输出格式为LaTeX。
• 示例代码：

  #| tbl-cap: "车辆参数描述性统计"
  #| tbl-label: "tab:car-stats"
  #| output: latex
  gtsummary::tbl_summary(mtcars, by = cyl)
  

  #| tbl-cap: "前5行车辆数据展示"
  #| tbl-label: "tab:car-data"
  gt::gt(mtcars[1:5, ])
  

• 配置完成后，Quarto会自动为表格编号，并将其纳入表格列表（List of Tables）。

二、图表自动纳入图表列表 #

图表（包括ggplot2、base R绘图等）的自动收录更直接，Quarto原生支持该功能：

• 在绘图代码块中添加 fig-cap（图表标题）和 fig-label（图表标签）参数即可。
• 示例代码：

  #| fig-cap: "马力与燃油效率的相关性"
  #| fig-label: "fig:hp-mpg"
  ggplot2::ggplot(mtcars, aes(x = hp, y = mpg)) +
    geom_point(color = "blue") +
    geom_smooth(method = "lm")
  

• 配置后，图表会自动被纳入图表列表（List of Figures）。

三、文档头部启用列表显示 #

在Quarto文档的YAML头部添加以下配置，才能在PDF开头显示表格列表和图表列表：

title: "你的毕业论文标题"
format:
  pdf:
    toc: true                # 启用目录
    lof: true                # 启用图表列表
    lot: true                # 启用表格列表
    number-sections: true    # 启用章节编号（可选，便于交叉引用）

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