如何使R-Quarto识别代码输出的div并正常渲染布局？

安全阿岳

2026-6-13

解决R-Quarto中动态生成布局指令不渲染的问题

要让代码输出的Quarto布局指令（比如:::{layout-ncol="2"}）被正确渲染，核心是让knitr把输出内容当成原始Markdown/Quarto语法解析，而非普通文本。以下是两种可行方法：

方法一：用`cat()`配合`results='asis'`代码块选项

给代码块添加results='asis'参数，让knitr直接将输出内容插入文档作为可渲染语法，而非转义为文本。

示例代码：

{r, echo=FALSE, results='asis'}
d <- "funtimes"
# 动态生成标题与布局块
cat(paste0("2. ", d), "\n\n")
cat(":::{layout-ncol=\"2\"}\n\n")
cat("Words\n\n")
cat("More Words\n\n")
cat(paste0(1:4, collapse="  \n"), "\n\n")
cat(paste0(1:4, collapse="  \n"), "\n\n")
cat(":::\n")

注意事项：

必须添加results='asis'选项，否则输出会被识别为普通文本
用\n控制换行，确保生成内容符合Markdown段落空行规则
引号需转义（如\"2\"），避免R字符串解析出错

方法二：使用`knitr::asis_output()`函数

若需在复杂逻辑中返回可渲染内容，可用knitr::asis_output()包裹输出，同样配合results='asis'选项。

示例代码：

{r, echo=FALSE, results='asis'}
d <- "funtimes"
output_content <- paste0(
  "2. ", d, "\n\n",
  ":::{layout-ncol=\"2\"}\n\n",
  "Words\n\n",
  "More Words\n\n",
  paste0(1:4, collapse="  \n"), "\n\n",
  paste0(1:4, collapse="  \n"), "\n\n",
  ":::\n"
)
knitr::asis_output(output_content)