markdown-it-mathjax3-pro —— 新一代 Markdown 数学公式渲染插件

markdown-it-mathjax3-pro —— 新一代 Markdown 数学公式渲染插件

markdown-it-mathjax3-pro 是一个基于 markdown-it 的强大插件，支持 MathJax 3，同时具备 服务端渲染（SSR） 和 客户端渲染（CSR） 两种模式，专为现代 Web 应用设计。

可以在github搜索项目名称，注意是pro，不是老版本。

https://github.com/NeoNexusX/markdown-it-mathjax3-pro

相较于 markdown-it-mathjax3，有哪些优势？

功能	markdown-it-mathjax3-pro	markdown-it-mathjax3
SSR/CSR 双模式支持	支持	不支持 CSR
数学公式批处理渲染	高性能
SVG 与 CHTML 输出可选	二选一	仅支持一种格式
可配置分隔符	灵活配置	部分支持
TypeScript 完善支持	完整类型定义	无类型定义
样式注入与自动处理	自动注入 CSS	需手动配置
零配置开箱即用	支持	部分需要配置
VitePress 等框架集成支持	自带示例与注入逻辑	需自行适配

核心特性一览

SSR + CSR 双渲染模式

SSR 模式下使用 MathJax-full 完成公式预渲染，适用于静态站点生成与 SEO 场景；

CSR 模式自动注入 MathJax 脚本，适用于互动性更强的 Web 应用。

高性能批处理渲染

所有公式统一构建成单一 MathJax 文档批量处理，大幅提升渲染效率，尤其在大量公式场景下表现优越。

️ 支持 SVG 与 CHTML 输出

可根据需求自由选择更适合的公式输出格式，兼顾样式一致性与渲染速度。

✍️ 灵活可配置

支持自定义行内和块级数学分隔符（如 \(...\)、§...§ 等），便于在不同语法偏好下使用。

零配置即用

默认配置覆盖主流使用场景，安装后即可立即使用。

框架集成友好

提供完善的 VitePress 使用示例与自动注入样式/脚本能力，便于快速集成进任意 Markdown 驱动的站点。

安装方式

npm install markdown-it-mathjax3-pro

开源与社区

本项目遵循 MIT 协议，欢迎各类贡献！

若您在使用过程中有任何问题，欢迎在 GitHub 提交 Issue。

文档 & 示例

中文文档（请替换为实际链接）

包含服务端与客户端渲染完整示例

VitePress 集成配置样例一应俱全

如果你正在寻找一个功能强大、兼容性好、配置灵活且适用于现代前端构建流程的 MathJax 渲染插件，markdown-it-mathjax3-pro 是你的不二之选！