在Github页面上使用MathJax？

Question

这里有一个基本问题。我正在尝试找到一种在Github网页上编写LaTeX格式公式的简单有效方法。

在这里，排名第一的答案建议使用MathJax作为可能的解决方案。

这个主题似乎暗示了MathJax不受支持。

就我个人而言，我已经按照这里的说明操作了，但数学公式没有出现。

有什么想法吗？

- Alex Zorn

---

它可以与Jekyll一起使用，因此可以在Github页面上使用原始HTML。请参见https://stackoverflow.com/questions/34227995/mathjax-being-parsed-with-jekyll/34231579#34231579 - David Jacquel

Answer 1

2022答案

现在，在GitHub上查看 .md 文件时，MathJax 已经得到本地支持。但是，在 GitHub Pages 上，它并不会自动支持。为了在 GitHub Pages 中启用 MathJax，最简单的方法是从CDN中包含脚本。

请注意: CDN已更改！要包含更新的脚本标记，请将此脚本标记添加到您的 _layouts/default.html 文件的<head/> 中。

<script type="text/javascript" id="MathJax-script" async
  src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js">
</script>

了解更多信息，请阅读MathJax关于使用CDN的文档页面。

额外帮助

如果您想使用美元符号（即$1 + 2$）来转义数学序列，还需添加以下内容：

<script>
  MathJax = {
    tex: {
      inlineMath: [['$', '$']]
    }
  };
</script>

更多信息请查看文档。

- nullromo

---

按照这些说明操作并没有生成_layouts/default.html文件。假设按照这些说明创建了一个新项目，我应该编写什么代码？ - Galen

您可以在此处查看有关Jekyll布局如何工作的信息。这里是一个小例子，以及相应的部署。请点击此处获取更多信息。另外，您还可以点击此处查看示例代码。 - nullromo

Answer 2

您可以通过在HTML代码的标签中添加下面的代码，在Github页面上使用Mathjax。

<script type="text/javascript" charset="utf-8" 
src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML,
https://vincenttam.github.io/javascripts/MathJaxLocal.js"></script>

我参考了这个页面。https://vincenttam.github.io/blog/2014/11/09/mathjax-local-configuration-file/

- Takeshi Ikeda

---

抱歉，需要添加代码"https://vincenttam.github.io/javascripts/MathJaxLocal.js"在"https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"之后。 - Takeshi Ikeda

CDN已更改。请查看我的答案以获取最新更新。 - nullromo