如何在Quarto博客项目中单独渲染单个HTML文件而不渲染整个项目

核心原因 #

Quarto会识别博客根目录的_quarto.yml配置，将子目录视为站点的一部分。当你在子目录中调用渲染命令时，Quarto默认会以项目模式运行，触发整个站点的构建流程，这会导致额外生成的文件被站点构建的清理步骤删除，同时渲染所有博客文章。

可行解决方案 #

1. 使用--no-project参数禁用项目模式 #

在调用quarto_render时，添加--no-project参数，强制Quarto仅渲染指定的单个文件，不加载站点配置：

setwd("posts/2022-10-28-myblog/")
quarto::quarto_render(
  input = "extra.qmd",
  output_file = "extra.html",
  args = "--no-project"
)

或者直接在命令行执行（效果相同）：

cd posts/2022-10-28-myblog/
quarto render extra.qmd --output extra.html --no-project

这个参数会让Quarto忽略当前目录所属的站点项目，仅处理单个文件，不会触发全站渲染，也不会删除你的输出文件。

2. 在站点配置中排除额外文件 #

在博客根目录的_quarto.yml中，将extra.qmd加入exclude列表，让站点构建时跳过该文件：

project:
  exclude:
    - posts/2022-10-28-myblog/extra.qmd

配置完成后，再执行你原本的渲染命令，Quarto就不会因为这个文件的存在触发全站构建，也不会在站点构建时删除该文件的输出。

3. 临时迁移文件（备选） #

如果不想修改配置或添加参数，可以将extra.qmd临时复制到一个不属于博客站点的目录（比如本地桌面），渲染完成后再把输出文件移回原目录。不过这种方法较为繁琐，仅作为应急方案。

验证效果 #

执行上述任一方案后，你会发现只有extra.qmd被渲染生成extra.html，主博客文章和其他博客文件不会被触发渲染，输出文件也不会被删除。

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