You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Quarto qmd文档YAML头引入外部YAML文件失败求助

在Quarto文档YAML头中正确引入外部YAML文件的方法

你遇到的错误是因为Quarto不支持将!include作为YAML顶层元素直接使用,以下是两种可行的正确方案:

方案1:合并外部YAML到当前配置(推荐)

使用YAML的合并语法<<: !include <外部YAML路径>,可将外部YAML的所有键值对合并到当前文档的YAML中;若存在键冲突,当前YAML的配置会覆盖外部YAML的内容。

修改后的test_file.qmd内容:

---
<<: !include external_yaml.yaml
title: "Yaml with external yaml"
---

# Tab

This is a test

方案2:单独引入特定字段

如果只需要外部YAML中的某个特定字段,可直接通过!include <外部YAML路径>#<字段名>的方式精准引入:

修改后的test_file.qmd内容:

---
title: "Yaml with external yaml"
author: !include external_yaml.yaml#author
format: !include external_yaml.yaml#format
---

# Tab

This is a test

版本兼容说明

以上两种方式均适配你使用的Quarto 1.4.537版本,执行渲染时不会再出现YAML解析错误。

内容的提问来源于stack exchange,提问作者Quinten

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.23 21:40:11