如何快速安装 GitHub-MathJax：让LaTeX公式在GitHub优雅显示的完整指南 🚀

GitHub-MathJax 是一款专为GitHub设计的Chrome扩展，能够让仓库中的LaTeX数学公式实现优雅渲染。基于开源的MathJax库开发，它解决了GitHub原生不支持数学公式显示的痛点，让技术文档和学术项目的公式展示更加专业清晰。

📌 核心功能亮点

• 即时渲染：自动识别GitHub页面中的LaTeX公式并实时渲染
• 右键菜单：支持缩放所有公式、查看TeX源代码等高级操作
• 轻量兼容：与GitHub页面无缝集成，不影响原有浏览体验
• 开源免费：基于New BSD License开源，代码完全透明可审计

📸 效果展示

图：安装扩展后GitHub页面中LaTeX公式的渲染效果对比

🔧 一键安装步骤

官方渠道安装（推荐）

1. 打开Chrome浏览器，访问Chrome Web Store
2. 搜索"MathJax Plugin for GitHub"
3. 点击"添加至Chrome"完成安装

手动安装（开发者选项）

1. 克隆仓库：git clone https://gitcode.com/gh_mirrors/gi/github-mathjax
2. 打开Chrome扩展页面：chrome://extensions/
3. 开启"开发者模式"
4. 点击"加载已解压的扩展程序"，选择克隆的仓库文件夹

⚙️ 核心文件解析

配置文件

• manifest.json：扩展核心配置，定义权限与注入规则
• mathjax_config.js：MathJax渲染参数设置，控制公式显示效果

核心脚本

• content.js：GitHub页面公式动态渲染主逻辑
• dynamic_math.js：处理动态加载内容中的数学公式

📝 使用方法

1. 安装完成后访问任意包含LaTeX公式的GitHub仓库
2. 公式会自动渲染，无需额外操作
3. 右键点击公式可打开上下文菜单：
   • 缩放所有数学公式
   • 查看TeX源代码
   • 复制公式图片或MathML代码

📄 许可证信息

本项目遵循New BSD License，基于Boris Gromov的wiki-mathjax项目开发，核心渲染能力由MathJax库提供。

💡 使用提示

• 对于大型公式仓库，首次加载可能需要2-3秒渲染时间
• 若公式未显示，可尝试刷新页面或检查网络连接
• 支持大多数LaTeX语法，包括复杂的矩阵和公式环境