双栏extarticle中Markdown表格longtable编译报错的解决问询

问题背景 #

在使用extarticle双栏模板的R Markdown生成PDF时，原生Markdown表格会被pandoc默认转换为LaTeX longtable环境，触发报错：

! Package longtable Error: longtable not in 1-column mode.

手动将表格转为LaTeX tabular环境可正常编译，但希望保留原生Markdown表格格式，以下是针对两个问题的解决方案：

1. 配置pandoc参数强制生成双栏兼容表格环境 #

可通过在YAML配置中添加pandoc-args，禁用longtable并指定使用双栏兼容的tabularx环境，无需修改文本中的Markdown表格格式：

修改后的完整YAML配置 #

---
output: 
  pdf_document: 
    latex_engine: xelatex
    keep_tex: no
    pandoc_args:
      - --variable=longtable:false  # 禁用longtable环境
      - --variable=table-use-tabularx  # 强制使用tabularx环境
documentclass: extarticle
classoption: "a4paper,8pt,oneside,twocolumn"
header-includes:
- \usepackage{lipsum}
- \usepackage{tabularx,booktabs,array}  # 加载依赖LaTeX包
---

关键说明：

• --variable=longtable:false：告知pandoc不使用longtable，避免双栏布局冲突；
• --variable=table-use-tabularx：强制pandoc将Markdown表格转为tabularx环境，适配双栏宽度；
• 需手动加载tabularx等包，因为禁用longtable后pandoc不会自动引入相关依赖。

2. 通过knitr全局设置或kable参数禁用longtable #

如果使用knitr::kable()生成表格，可通过全局配置或直接指定参数，强制不使用longtable：

方法1：全局设置（在setup代码块中） #

```{r setup, include=FALSE}
knitr::opts_chunk$set(echo = TRUE)
# 全局指定kable输出格式为LaTeX，且禁用longtable
options(knitr.table.format = "latex")
knitr::opts_chunk$set(kable.longtable = FALSE)

### 方法2：单个kable调用时指定参数
```r
```{r}
# 直接在kable中设置longtable=FALSE
knitr::kable(your_data, longtable = FALSE, booktabs = TRUE)

#### 进阶优化（自动换行适配双栏）：
若表格内容过长，可结合`kableExtra`调整列宽实现自动换行：
```r
```{r}
knitr::kable(your_data, longtable = FALSE, booktabs = TRUE) %>%
  kableExtra::kable_styling(latex_options = "hold_position") %>%
  kableExtra::column_spec(2, width = "11cm")  # 根据双栏实际宽度调整

---

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