R-Markdown导出PDF时gt_summary表格显示顺序异常求助

问题原因 #

PDF导出依赖LaTeX渲染，gt生成的表格默认是浮动体（float），LaTeX会自动调整浮动元素位置以优化页面排版，这就导致表格可能跑到标题前面；而HTML和Word采用流式布局，元素严格按文档顺序渲染，因此不会出现这个异常。

解决方案 #

方案1：禁用表格浮动属性 #

在as_gt()后添加tab_options(table.float = FALSE)，强制LaTeX将表格作为非浮动元素，严格按文档顺序排版：

---
title: "gt_summary PDF Test"
output: pdf_document
---

# 测试标题

```{r}
library(gt)
library(gtsummary)

mtcars %>%
  select(mpg, cyl, disp) %>%
  tbl_summary() %>%
  as_gt() %>%
  tab_options(table.float = FALSE)

### 方案2：用LaTeX命令强制排版顺序
在标题和代码块之间插入`\FloatBarrier`命令，强制LaTeX先排完之前所有浮动元素，再处理后续内容：

```r
---
title: "gt_summary PDF Test"
output: pdf_document
---

# 测试标题

\FloatBarrier

```{r}
library(gt)
library(gtsummary)

mtcars %>%
  select(mpg, cyl, disp) %>%
  tbl_summary() %>%
  as_gt()

### 方案3：直接使用tbl_summary默认输出（无需转gt对象）
如果不需要gt的额外样式，直接输出`tbl_summary()`结果即可——它会用knitr的原生表格渲染逻辑，避免浮动体问题：

```r
---
title: "gt_summary PDF Test"
output: pdf_document
---

# 测试标题

```{r}
library(gtsummary)

mtcars %>%
  select(mpg, cyl, disp) %>%
  tbl_summary()

内容的提问来源于stack exchange，提问作者Pedro Rizzi de Oliveira