R基于flexdashboard制作rbokeh交互仪表板的YAML解析错误问询

rmarkdown 渲染Rmd文件时，会优先扫描文件最开头的YAML Front Matter区域，严格遵循以下识别规则：

• 仅将文件最起始位置、被成对---包裹的段落判定为YAML配置块
• 若第一行未检测到作为YAML起始标记的---，解析器会逐行向后扫描匹配文档起始点。你遇到的Parser error: did not find expected <document start> at line 2, column 1报错，本质就是扫描到第二行第一列位置时，没有找到符合规范的YAML起始标记。

结合你的操作流程，可逐一对应排查所有可能的触发点：

• 排除title、author字段配置本身的问题：如果仅存在字段值写法不规范（比如特殊字符未加引号、缩进错位），触发的报错会是“无法识别的字符标记”类提示，不会出现“找不到文档起始”的描述。
• 排除依赖版本问题：你当前使用的R 4.0.3、rmarkdown 2.7、flexdashboard 0.5.2版本组合，完全满足flexdashboard渲染的依赖要求，版本不兼容不会触发当前YAML解析错误。
• 最高概率的触发原因是操作流程疏漏：
  • 创建Rmd模板、删除原有内容时，误删了模板最开头的---YAML起始标记，粘贴目标代码后直接把title、author这类YAML字段放在文件第一行，解析器从第一行扫描时没找到YAML块的起始边界，到第二行就会抛出对应报错。
  • 从目标站点复制代码时，粘贴内容最前端携带了隐藏空行，空行占了文件第一行，第二行才是真正的---YAML起始标记，解析器会把第一行空行判定为正式文档内容，后续碰到的---就不再被识别为合法的YAML块边界。
• 次概率触发原因是参考代码本身存在缺陷：部分站点分享的示例代码，只会粘贴YAML块内部的字段配置内容，省略了包裹YAML的两个---边界标记，直接粘贴使用必然会触发当前解析错误。

按照以下步骤调整即可正常渲染离线HTML文件：

• 打开“我的文档”路径下的目标Rmd文件，拉到文件最顶部检查前三行内容，确保文件第一行没有空行、没有冗余文本，直接顶格书写---作为YAML块的起始标记。
• 把从目标站点获取的title、author、output配置字段，统一放在两个---标记中间，标准结构参考如下：

  ---
  title: "rbokeh鸢尾花交互式仪表板"
  output:
    flex_dashboard:
      self_contained: true
  ---
  

• 确认YAML块的闭合标记---顶格书写，没有多余缩进，后续的正文、rbokeh绘图代码块直接跟在闭合标记后方，不要把代码块内容粘到YAML区域内部。
• 调整完成后直接通过RStudio的Knit功能渲染，选择导出自包含的HTML文件，即可获得可离线访问的交互式仪表板。

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