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

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

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

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

python 复制代码
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 驱动的站点。

📦 安装方式

powershell 复制代码
npm install markdown-it-mathjax3-pro

🤝 开源与社区

本项目遵循 MIT 协议,欢迎各类贡献!

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

📚 文档 & 示例

中文文档(请替换为实际链接)

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

VitePress 集成配置样例一应俱全

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