渲染Quarto文档时出现YAML解析错误，该如何排查解决？

错误现象 #

渲染Quarto文档时弹出以下YAML解析错误，即使简化文档顶部的YAML元数据为最简结构，错误依然存在：

Error in yaml::yaml.load(meta, handlers = list(expr = parse_only)) : 
  Parser error: while parsing a block mapping at line 1, column 1 did not find expected key at line 2, column 27
Calls: .main ... FUN -> parse_block -> partition_chunk -> <Anonymous>
Execution halted

问题根源 #

错误并非来自文档顶部的YAML区域，而是代码块内的单元格选项存在语法失误。在示例代码中，R代码块的tbl-cap选项行末尾多了一个多余的右括号)：

```{r}
#| label: tbl-exibble
#| tbl-cap: "Exibble Bla Bla")  # 此处多了一个右括号

gt::gt(exibble)

这个多余的括号破坏了Quarto代码块选项的YAML格式解析规则，导致解析器无法识别正确的键值对结构。

### 修正方法
移除`tbl-cap`行末尾的多余右括号即可正常渲染：
```r
```{r}
#| label: tbl-exibble
#| tbl-cap: "Exibble Bla Bla"

gt::gt(exibble)

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