R Markdown导出HTML上传SharePoint后TOC、plotly等无法渲染如何解决

• SharePoint 默认的在线HTML预览机制会主动拦截、过滤HTML文件中的内联/外部JavaScript脚本、自定义CSS样式，而R Markdown生成的HTML输出的浮动目录、plotly交互图表、leaflet地图等功能全部依赖JS和对应CSS资源运行，被过滤后就会出现渲染错乱的问题。
• 默认html_document输出会调用公共CDN上的依赖资源，就算没被过滤，部分企业内网也可能拦截外部CDN请求导致资源加载失败。

方案1：修改R Markdown输出配置，生成完全自包含的HTML文件 #

修改你的YAML头配置如下，把所有依赖全部内嵌到HTML文件里，减少外部依赖同时降低被安全规则拦截的概率：

---
title: "Test_Output"
output: 
  html_document:
    toc: true
    toc_float: true
    # 核心配置：所有JS、CSS资源全部内嵌到HTML单文件，不调用外部CDN
    self_contained: true
    # 不需要渲染公式的话直接关闭mathjax，减少不必要的外部依赖
    mathjax: null
    highlight: tango
---

生成文件上传到Sharepoint后，修改访问链接的后缀参数：把原链接末尾的参数替换为?web=1，强制浏览器直接渲染HTML文件而非调用Sharepoint自带的预览器。

方案2：换用flexdashboard输出格式 #

如果是做数据看板类内容，flexdashboard的输出结构更简洁，被Sharepoint过滤的内容更少，适配性更强，修改YAML头即可：

---
title: "Test_Output"
output: 
  flexdashboard::flex_dashboard:
    orientation: columns
    vertical_layout: fill
    self_contained: true
---

同样配合?web=1的链接参数使用，大部分场景都能正常渲染所有交互元素。

方案3：企业级限制下的替代方案 #

如果上述配置都不生效，说明你们公司的Sharepoint做了严格的静态资源安全限制，可以考虑：

• 将输出内容发布到公司内部的静态页托管服务，比如内网web服务器、Teams内置的维基页面
• 改用Quarto生成HTML输出，它的自包含打包逻辑比传统R Markdown更完善，对企业内网环境的适配性更高

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