You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在GitHub的README.md文件中正常显示LaTeX数学公式

GitHub README无插件全局可用LaTeX公式渲染方案
  • 方案1:直接使用GitHub原生支持(首选,最简单)

    GitHub自2022年起已内置MathJax渲染能力,无需任何额外配置、插件,所有访问者都能直接看到渲染后的公式,语法完全兼容标准LaTeX:
    • 块级公式使用$$前后包裹,你示例的$$E=mc^2$$直接写入README即可正常渲染成块级公式
    • 行内公式使用单个$前后包裹,如$\int_0^1 f(x)dx$会在行内对应位置显示公式
      遇到特殊符号按照LaTeX标准做转义处理即可。
  • 方案2:静态图片嵌入(兼容性最强)

    如果需要兼容极旧版本浏览器,可以提前将所有公式导出为SVG或PNG格式图片,上传到仓库的静态资源目录(比如新建assets文件夹)后,用Markdown图片语法插入到对应位置即可,示例写法:
    ![E=mc²公式](./assets/emc2.svg)
    你可以用本地LaTeX环境导出公式图片,也可以用公共公式生成工具导出后存入仓库,这种方式只要浏览器支持图片显示就能正常查看内容。
  • 方案3:GitHub Actions自动转换(适合公式多的项目)

    如果你的README公式数量多、更新频繁,可以配置简单的GitHub Actions工作流,每次提交代码时自动识别文件中的LaTeX语法,批量转换为图片嵌入到对应位置,无需手动处理每一张公式图,适合内容迭代快的技术文档项目。

内容的提问来源于stack exchange,提问作者Peanutlex

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.07 10:33:03