flexdashboard中YAML头无法解析：navbar标题表达式报错

问题场景 #

在flexdashboard的YAML配置中，使用!expr Sys.Date()可正常在导航栏右侧显示日期，但改用带格式化字符串的表达式时，YAML解析报错：

Error in yaml::yaml.load(..., eval.expr = TRUE) : Could not parse
expression: format(Sys.Date(), "Created on Calls: ...
parse_yaml_front_matter -> yaml_load -> Execution halted

报错的配置片段：

navbar:
    - title: !expr format(Sys.Date(), "Created on: %Y-%m-%d")
      href: "#"
      align: right

解决方法 #

问题根源是YAML会将双引号内的:加空格识别为键值对分隔符，截断了R表达式。以下两种方案可解决：

方案1：用单引号包裹格式化字符串

把格式化字符串的双引号替换为单引号，避免YAML解析内部特殊符号：

---
output:
  flexdashboard::flex_dashboard:
    orientation: rows
    theme:
      version: 3
      bootswatch: flatly
    vertical_layout: fill
    navbar:
        - title: !expr format(Sys.Date(), 'Created on: %Y-%m-%d')
          href: "#"
          align: right
---

方案2：用括号包裹完整R表达式

给!expr后的整个R表达式加上括号，明确界定表达式范围：

---
output:
  flexdashboard::flex_dashboard:
    orientation: rows
    theme:
      version: 3
      bootswatch: flatly
    vertical_layout: fill
    navbar:
        - title: !expr (format(Sys.Date(), "Created on: %Y-%m-%d"))
          href: "#"
          align: right
---

原理说明 #

YAML对双引号内的:+空格组合会默认解析为键值对结构，导致format函数的第二个参数被错误截断，引发表达式解析失败。上述两种方法都能让YAML正确识别完整的R表达式，避免语法冲突。

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