如何在Quarto文档中嵌入R函数生成的HTML内容？

Quarto默认会对R代码输出的字符串进行转义，这就是你生成的HTML标签以纯文本形式显示而非渲染的原因——它和R Markdown的默认处理逻辑不同。下面是两种直接可行的解决方案：

方法一：用htmltools::HTML()标记HTML内容 #

通过htmltools包的HTML()函数包裹生成的HTML字符串，明确告诉Quarto这是需要解析渲染的HTML代码，而非普通文本。

示例代码 #

1. R脚本中的imageLink函数（iframe同理，替换标签即可）：

imageLink <- function(src, alt) {
  sprintf('<img src="%s" alt="%s" />', src, alt)
}

2. Quarto文档中的代码块：

library(htmltools)
# 调用函数并标记为HTML内容
HTML(imageLink("your-image-path.jpg", "描述文本"))

方法二：使用results='asis'代码块选项 #

如果不想依赖htmltools，可以给R代码块添加results='asis'选项，让Quarto直接将输出内容写入最终HTML文档，不做转义处理。注意这种方式需要用cat()输出字符串：

#| results: asis
# 调用函数并直接输出
cat(imageLink("your-image-path.jpg", "描述文本"))

注意事项 #

• 对于iframe场景，只需要把sprintf里的<img>标签替换成<iframe>即可，两种方法完全通用。
• 如果需要批量生成多个HTML元素，推荐用htmltools::tagList()组合多个HTML()对象再输出，避免手动拼接字符串的麻烦。

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