R Markdown导出HTML数学公式离线不渲染 如何配置实现正常显示

默认R Markdown导出HTML时，数学公式默认调用在线CDN加载MathJax渲染资源，无网络环境下无法触发渲染，就会直接展示$、$$包裹的原始LaTeX公式代码，和你描述的故障表现完全匹配。

一键生效配置 #

打开你对应R Markdown文档的YAML头部配置块，替换/添加如下html_document输出参数：

output:
  html_document:
    mathjax: local
    self_contained: true

配置完成后重新Knit编译即可。

配置说明与注意事项 #

• 首次使用mathjax: local参数编译时需要保持联网，R会自动将对应版本的MathJax资源下载到本地R包缓存目录，后续所有编译操作都不需要再联网
• self_contained: true为默认开启参数，如果你之前手动将其修改为false必须改回，该参数会将MathJax渲染资源、文档样式、图片等所有依赖全部打包进单个HTML文件，接收文件的用户不需要额外下载任何资源，直接打开就能看到正常渲染的公式
• 如果之前多次编译产生过异常缓存，建议先删除旧的HTML输出文件，再执行全量编译，避免缓存残留导致渲染异常

备用方案（本地MathJax下载失败时使用） #

如果遇到本地MathJax资源拉取失败的问题，可以切换为KaTeX渲染引擎，配置如下：

output:
  html_document:
    math_method: katex
    self_contained: true

KaTeX渲染引擎体积更小、公式加载速度更快，对主流LaTeX数学语法兼容性和MathJax基本一致，同样支持全资源嵌入单HTML文件离线查看。

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