Markdown无法识别output配置 运行提示object 'output' not found错误

问题现象 #

运行包含如下YAML配置的文档时持续触发报错，相同代码此前可正常运行，当前使用的YAML配置代码如下：

---
output: 
  word_document:
    reference_docx: format.docx
---

运行后返回错误信息：

Error: object 'output' not found

该错误和Markdown基础语法无关，核心是R Markdown专属的YAML配置块被当成普通R代码解析：R解释器会将配置中的output识别为待调用的变量，当前运行环境不存在该变量时就会抛出对应报错。
常见触发场景如下：

• 误将.Rmd文件的全部内容选中粘贴到R控制台逐行运行，或是使用执行普通R脚本的source()命令运行R Markdown文件
• YAML配置块没有放在文件的绝对起始位置，块前方存在空行、注释、普通文本等内容，导致渲染流程无法识别配置头，将后续内容按普通R代码处理
• 使用不支持R Markdown渲染规则的纯Markdown工具（比如原生Markdown预览插件、普通文本编辑器的Markdown预览功能）触发渲染，无法识别R Markdown专属的YAML配置字段
• 此前代码能正常运行，大概率是之前通过正确的R Markdown渲染入口触发执行，当前误操作走了普通代码执行逻辑，或是调整文件内容时不小心在YAML块前加了多余字符导致配置头识别失效

• 首先确认文件后缀为.Rmd而非普通.md，YAML配置块必须从文件第一行开始书写，前后用---包裹，块前不能残留任何字符。你提供的YAML配置本身语法没有错误，保持正确位置即可。
• 不要单独选中运行YAML块内容，也不要用运行普通R脚本的方式执行Rmd文件：使用R Markdown专属的渲染逻辑即可，比如在R环境中执行rmarkdown::render("你的文件实际存储路径.Rmd")，如果使用RStudio编辑器，直接点击编辑区顶部的「Knit」按钮即可正常触发渲染。
• 确认配置中引用的format.docx样式模板和当前Rmd文件处于同一工作目录下，避免路径错误连带导致配置识别失败。
• 如果你只是编写普通Markdown文档、不需要渲染为Word格式，直接删除这段YAML配置块即可，普通Markdown预览流程不需要该段配置。

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