Quarto HTML输出存SharePoint后功能失效求助

核心问题原因 #

SharePoint的安全策略会限制HTML中外部资源加载，同时你的Quarto配置存在**code-fold层级错误**，且部分交互功能需要额外配置确保资源完全嵌入，才适配SharePoint的环境。

修改后的YAML配置 #

format: 
  html:
    fig-width: 12
    fig-height: 7
    code-overflow: wrap
    toc: true
    toc-float: true
    embed-resources: true
    code-fold: true
    self-contained: true
    theme: cosmo

关键修改说明 #

• 修正code-fold层级：原配置中code-fold与format同级，属于全局配置，但Quarto的code-fold是HTML格式专属选项，必须放在html子节点下才会生效。
• 添加self-contained: true：和embed-resources配合，强制将所有CSS、JS、字体等资源嵌入单个HTML文件，彻底避免SharePoint阻止外部资源加载的问题。
• 显式声明toc-float: true：在受限环境下显式声明，确保Quarto生成浮动目录的交互逻辑。
• 指定内置主题：避免Quarto尝试加载CDN上的主题资源，改用内置主题资源直接嵌入，规避加载限制。

额外验证步骤 #

1. 重新渲染文档后，查看HTML源代码，确认没有外部http/https资源链接（本地图片会自动嵌入）。
2. 上传到SharePoint后，右键选择「在新标签页中打开」，而非使用SharePoint内置预览窗格（预览窗格本身会限制部分交互功能）。

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