GitHub 中的 Markdown 公式显示答案

【问题标题】：Markdown formula display in GitHubGitHub 中的 Markdown 公式显示
【发布时间】：2012-09-12 05:14:12
【问题描述】：

当我在 RStudio 和 Knit HTML 中编写 R markdown 文件时，我的公式（使用 $..$ 内联或使用 $$..$$ 显示）可以正确显示。但是，当我将 .md 文件推送到 GitHub 时，这些公式无法显示。它们只显示 $..$ 和 $$..$$。有没有办法让 GitHub 知道如何解析乳胶公式？谢谢！

【问题讨论】：

没有。 Github 不支持 Mathjax，除非在他们的 Wiki 中。唯一的选择是使用 jekyll 在本地生成 HTML 并将其推送到 github。

标签： r github markdown knitr rstudio

【解决方案1】：

有没有办法让 GitHub 知道如何解析 Latex 公式？

一些网站为用户提供无需任何 javascript 即可满足您的需求的服务：从 url 编码的乳胶公式即时生成图像。

codecogs.com
iTex2Img。

给定以下 markdown 语法

![equation](https://latex.codecogs.com/gif.latex?1%2Bsin%28mc%5E2%29%0D%0A)

它将显示以下图像

注意：为了正确显示图像，您必须确保 url 的查询字符串部分是 percent encoded。您可以轻松找到帮助您完成该任务的在线工具，例如 www.url-encode-decode.com

【讨论】：

谢谢！我在 mdcharm 中尝试过，似乎没有 urlencoding 也可以工作。
通过在链接中使用svg.latex，你会得到一个漂亮的SVG图像文件。

【解决方案2】：

我也在寻找如何在 GitHub 页面上渲染数学，经过长时间的研究，我找到了一个不错的解决方案。

我使用 KateX 来渲染公式服务器端：它确实比 MathJaX 快。

请注意，同样的解决方案也可以安排在客户端工作，但是，我更喜欢服务器端渲染，原因

您了解自己的服务器环境，但不了解访问者的客户端环境
它也是客户端更快，如果公式在服务器上呈现，只呈现一次。

我写了一篇展示步骤的文章，希望对数学的普及有所帮助：见Math on GitHub Pages。

【讨论】：