Knitr/RMarkdown非交互式渲染列表换行异常问题求助

问题现象 #

使用RMarkdown渲染report包生成的列表时，出现仅在非交互式模式下触发的异常：

• 交互式环境直接执行rmarkdown::render('test_rmarkdown.Rmd', 'html_document')，列表格式正常；
• 通过Rscript或shell直接启动R执行渲染命令时，生成的Markdown文件中列表项会出现硬换行，导致列表结构被破坏。

复现代码 #

将以下内容保存为test_rmarkdown.Rmd：

---
title: Rmarkdown Test
---

```{r, message = FALSE}
library("dplyr")
library("report")

iris %>%
    dplyr::select(Petal.Length, Species, everything()) %>%
    dplyr::rename(Spe = Species) %>%
    report::report(.) %>%
    summary()

sessionInfo()

### 异常输出示例
非交互式渲染后，生成的`test_rmarkdown.md`中出现破坏列表的硬换行：
```markdown
The data contains 150 observations of the following 5 variables:

  - Petal.Length: n = 150, Mean = 3.76, SD = 1.77, range: [1, 6.90]
  - Spe: 3 levels, namely setosa (n = 50), versicolor (n = 50) and virginica (n =
50)
  - Sepal.Length: n = 150, Mean = 5.84, SD = 0.83, range: [4.30, 7.90]
  - Sepal.Width: n = 150, Mean = 3.06, SD = 0.44, range: [2, 4.40]
  - Petal.Width: n = 150, Mean = 1.20, SD = 0.76, range: [0.10, 2.50]

原因分析 #

这不是knitr的bug，而是终端宽度限制导致的输出自动换行：

• 非交互式环境中，R的输出宽度受终端窗口大小限制，report::summary()生成的长列表项会被自动拆分为多行；
• 当knitr以results="asis"模式输出时，会直接保留这些硬换行，而Markdown语法中，列表项内的硬换行会被解析为新段落，从而破坏列表结构。

临时解决方案 #

通过cat函数统一控制输出格式，避免终端自动换行的影响：

```{r, results = "asis"}
iris %>%
    dplyr::select(Petal.Length, Species, everything()) %>%
    dplyr::rename(Spe = Species) %>%
    report::report(.) %>%
    summary() %>%
    paste0("\n") %>%
    cat

## 环境信息
```r
R version 4.5.0 (2025-04-11)
Platform: x86_64-pc-linux-gnu
Running under: CentOS Linux 7 (Core)

Matrix products: default
BLAS/LAPACK: /opt/intel/oneapi/mkl/2023.0.0/lib/intel64/libmkl_gf_lp64.so.2;  LAPACK version 3.10.1

locale:
 [1] LC_CTYPE=en_US.utf8       LC_NUMERIC=C             
 [3] LC_TIME=en_US.utf8        LC_COLLATE=en_US.utf8    
 [5] LC_MONETARY=en_US.utf8    LC_MESSAGES=en_US.utf8   
 [7] LC_PAPER=en_US.utf8       LC_NAME=C                
 [9] LC_ADDRESS=C              LC_TELEPHONE=C           
[11] LC_MEASUREMENT=en_US.utf8 LC_IDENTIFICATION=C       

time zone: Europe/Berlin
tzcode source: system (glibc)

attached base packages:
[1] stats     graphics  grDevices datasets  utils     methods   base      

other attached packages:
[1] report_0.6.1   dplyr_1.1.4    rmarkdown_2.29

loaded via a namespace (and not attached):
 [1] vctrs_0.6.5       cli_3.6.5         knitr_1.50        rlang_1.1.6      
 [5] xfun_0.52         renv_1.1.4        generics_0.1.4    jsonlite_2.0.0   
 [9] glue_1.8.0        htmltools_0.5.8.1 sass_0.4.10       datawizard_1.1.0 
[13] evaluate_1.0.4    jquerylib_0.1.4   tibble_3.3.0      fastmap_1.2.0    
[17] yaml_2.3.10       lifecycle_1.0.4   insight_1.3.0     compiler_4.5.0   
[21] pkgconfig_2.0.3   digest_0.6.37     R6_2.6.1          tidyselect_1.2.1 
[25] pillar_1.10.2     magrittr_2.0.3    bslib_0.9.0       withr_3.0.2      
[29] tools_4.5.0       cachem_1.1.0

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