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 是你的不二之选! 🎯