如何将Quarto参数移至独立文件？现有尝试均失败

问题背景 #

Quarto 1.3.433版本中，将params从index.qmd内移至独立_metadata.yml文件时，出现"object 'params' not found"或YAML文档流错误，以下是可行的解决配置：

正确配置方式 #

1. 编写独立元数据文件 #

_metadata.yml文件不要添加---分隔符，直接写入参数：

params:
  sample_param: "默认值"
  num_param: 456

2. 命令行指定元数据文件渲染 #

执行渲染时使用--metadata-file参数，而非--execute-params：

quarto render index.qmd --metadata-file _metadata.yml

3. 在文档头部引入元数据文件 #

在index.qmd的YAML头部添加metadata-files配置：

---
title: "示例文档"
metadata-files:
  - _metadata.yml
---

之后直接运行常规渲染命令：

quarto render index.qmd

错误原因解析 #

• --execute-params用于临时覆盖已有params，并非指定外部配置文件，所以会触发找不到params的错误。
• 给_metadata.yml加---会导致Quarto解析YAML时出错，独立元数据文件不需要分隔符，直接写配置内容即可。

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