rmarkdown 2.11+版本无法正常渲染billboarder图表问题

该兼容性问题源自rmarkdown 2.11版本新增的HTML widgets沙箱渲染机制：

• DOM中出现的chart-shim类外层div，就是该机制生成的沙箱隔离容器，设计目的是避免widget脚本污染全局页面环境
• 沙箱逻辑会把billboarder存储渲染配置的script标签直接插入billboarder htmlwidget容器内部，而billboarder的初始化逻辑默认读取容器同级的配置脚本，无法匹配到配置参数时就不会执行SVG绘制，最终表现为图表区域空白
• Shiny运行时不会调用静态R Markdown文档的沙箱渲染流程，因此相同图表代码在Shiny中DOM结构完整、可正常渲染，和实际观测到的现象完全吻合

临时规避方案（立即生效） #

• 版本回退：将rmarkdown降级到2.10版本，即问题出现前的最后一个正式版本，安装指定版本可执行命令：
  remotes::install_version("rmarkdown", version = "2.10")
• YAML配置关闭沙箱：无需调整包版本，在R Markdown文档的YAML头部添加如下配置，关闭widget沙箱特性即可正常渲染：

output:
  html_document:
    pandoc_args: ["--metadata", "htmlwidgets-shim=false"]

• 全局参数关闭：在文档第一个R代码块中运行全局配置，直接禁用沙箱逻辑：
  options(htmlwidgets.shim = FALSE)

永久修复方向 #

目前rmarkdown和billboarder均未发布针对该冲突的官方适配，提交issue时可附上已验证的定位信息：问题触发的起始版本、静态文档与Shiny场景的DOM结构差异、沙箱层导致配置脚本位置异常的具体表现，可帮助维护者快速定位修复。

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