如何在RStudio的Quarto项目中自定义输出目录？

针对你迁移Rmarkdown到Quarto过程中遇到的两个问题，给出以下具体解决方案：

1. 消除output目录下的嵌套子目录 #

Quarto默认会将源文件的相对目录结构映射到output-dir中，因此quarto/test_render.qmd会被输出到output/quarto/test_render.pdf。要让文件直接输出到output根目录，可通过两种方式实现：

方式一：全局项目配置（_quarto.yml） #

在_quarto.yml中添加render规则，指定不保留源文件的目录结构：

project:
  title: "r_thesis"
  output-dir: output
  render:
    - source: quarto/*.qmd
      output-dir: output
      relative: false  # 禁用源目录结构映射

如果仅针对单个文件，也可以直接固定输出路径：

project:
  title: "r_thesis"
  output-dir: output
  render:
    - "quarto/test_render.qmd":
        output-dir: output

方式二：单个QMD文件独立配置 #

在目标qmd文件的YAML头部直接指定输出路径（相对于当前文件位置）：

---
title: "Test Render"
output: pdf_document
output-dir: ../output
---

2. 修复本地浏览器无法自动找到渲染文件的问题 #

这个问题源于Quarto预览时的路径识别错误，可通过两种方式解决：

• 全局配置预览路径：在_quarto.yml中添加preview配置，明确指定预览文件的根目录：

project:
  title: "r_thesis"
  output-dir: output
  preview:
    output-dir: output

• CLI命令直接指定：使用Quarto命令行渲染时，同时指定输出目录和预览参数：

quarto render quarto/test_render.qmd --output-dir output --preview

以上配置完成后，渲染产物会直接存放在output根目录，且Quarto能正确识别文件路径，自动在本地浏览器中打开预览。

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