MathJax：Quarto 网站与 Reveal 幻灯片

js/mathjax-quarto 目录索引

Quarto

MathJax

Reveal.js

JavaScript

Author

Harness 技术文档

Published

October 13, 2026

本目录存放 Quarto 网站与 Reveal.js 幻灯片 的离线公式运行时：MathJax 4.1.3 组合组件、本地字体，以及接入 YAML / Reveal 模板的片段。

js/mathjax-xaringan/ 是另一套资产。它服务于 xaringan，配置的是 MathJax 2 的 tex2jax 与 nature.beforeInit，并配有 knitr hook。两套文件解决的宿主不同，不能互相替换。

可交付文件

路径	落到业务项目	说明
`runtime/`	`vendor/mathjax/`	`load-mathjax.js`、`tex-chtml.js`、`input/tex/extensions/boldsymbol.js`、`woff2/`、`dynamic/`，以及 `LICENSE` / `NOTICE`
`snippets/quarto-html-math.yml`	合并进 `_quarto.yml`	普通 HTML 的 `html-math-method`
`snippets/reveal-math-block.txt`	写入 Reveal 模板	`mathjax3` 与 `RevealMath.MathJax3`
`patch-reveal-template.ps1`	不复制	从本机 Quarto 模板生成 `reveal-template.html`

在 harness 仓库根：

.\scripts\powershell\Install-Harness.ps1 `
  -InstallProfile mathjax-quarto `
  -ProjectRoot "D:\path\to\your-quarto-site"

然后按深度生成 Reveal 模板。两级目录（slide/name.html）使用默认相对路径：

.\js\mathjax-quarto\patch-reveal-template.ps1 `
  -Destination "D:\path\to\your-quarto-site\vendor\mathjax\reveal-template.html"