如何在R中渲染Quarto文档时动态设置HTML文件名

方案一：使用预渲染脚本（Pre-render Script） #

这是Quarto官方推荐的动态配置输出路径的方式，能在渲染前根据参数和系统日期生成自定义文件名。

1. 修改Quarto文档的YAML配置
   在你的.qmd文件头部添加pre-render字段，指定一个R脚本作为前置处理脚本：

---
title: "Example"
author: "Anthony"
params:
  variable: "var1"
format: html
pre-render: "render_setup.R"
---

2. 编写预渲染脚本render_setup.R
   在同目录下创建这个R脚本，通过Quarto的API获取元数据和参数，动态设置输出文件名：

# 首次运行需执行install.packages("quarto")安装依赖包
library(quarto)

# 获取文档元数据与参数
doc_meta <- quarto_metadata()
today_date <- Sys.Date()

# 拼接自定义输出文件名
output_name <- paste0(
  doc_meta$title, "_",
  doc_meta$params$variable, "_",
  doc_meta$author, "_",
  today_date,
  ".html"
)

# 配置Quarto使用该输出文件名
quarto_config_set(output_file = output_name)

渲染文档时，Quarto会先执行render_setup.R，再用设置好的文件名生成HTML，避免覆盖旧文件。

方案二：通过R代码直接调用渲染（适合自动化批量场景） #

如果需要批量或程序化渲染，可以直接在R脚本中调用quarto::render，手动指定输出文件名：

library(quarto)

# 定义目标参数
target_var <- "var1"

# 渲染并指定自定义文件名
quarto::render(
  input = "your_doc.qmd",
  output_file = paste0("Example_", target_var, "_Anthony_", Sys.Date(), ".html"),
  params = list(variable = target_var)
)

为什么之前的方法失效？ #

• Quarto不支持RMarkdown的knit字段，该逻辑是RMarkdown专属的渲染钩子。
• YAML中的output-file字段在Quarto的配置解析阶段生效，此时文档内容的R代码或短代码（如{{< meta >}}）还未被解析，因此无法直接嵌入动态逻辑。

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