rmarkdown::render生成PDF时kableExtra表格格式丢失如何解决

手动在RStudio点击knit时，rmarkdown会自动将输出格式上下文传递给kableExtra，kable会自动生成适配PDF的LaTeX格式表格。但通过独立脚本调用rmarkdown::render()时，部分场景下kableExtra无法自动识别输出格式，会默认输出纯Markdown格式表格，渲染为PDF时就会丢失所有表格样式，仅展示原始文本。

按照以下优先级调整即可解决问题：

1. 强制指定kable输出格式为LaTeX #

修改你的.Rmd文件中的表格生成代码，手动指定format = "latex"，并搭配kable_styling()加载默认PDF表格样式：

library(kableExtra)
kable(iris[params$test], format = "latex", booktabs = TRUE) %>%
  kable_styling(latex_options = "hold_position")

参数说明：

• booktabs = TRUE：调用LaTeX的booktabs宏包生成更美观的表格边框
• latex_options = "hold_position"：固定表格在文档中的位置，避免自动浮动

注意：如果表格内容包含LaTeX特殊字符（如下划线、百分号），且不需要解析为LaTeX命令，保持默认的escape = TRUE即可，避免编译报错。

2. 补充YAML配置依赖 #

如果调整代码后仍出现格式异常，在.Rmd的YAML头部声明PDF输出需要的LaTeX依赖，避免渲染时宏包缺失：

---
output:
  pdf_document:
    extra_dependencies: ["booktabs", "multirow", "xcolor"]
params:
  test: 1
---

以上三个宏包都是kableExtra生成复杂表格时常用的依赖。

3. 脚本调用时明确指定输出格式 #

调用rmarkdown::render()时手动指定output_format参数，避免格式识别偏差：

library(rmarkdown)
rmarkdown::render(
  input = "test_sams.rmd",
  output_format = "pdf_document",
  params = list(test = 1)
)

可以先在YAML中添加keep_tex: true配置，渲染后查看生成的.tex文件：如果表格部分是\begin{table}...\end{table}的LaTeX代码就是正常的，如果是| Sepal.Length |这种Markdown表格语法，说明格式指定没有生效，再回头检查代码里的format参数是否正确设置。

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