GitHub中Markdown内的公式渲染

参考

Markdown in Github

目前GFM(GitHub Flavored Markdown)官方文档中没有任何与公式(Equation)相关的条目,这表明目前GFM是不支持公式的。

stack overview上的回答中的解释:

GitHub中markdown的解析是由SunDown库完成的,这个库的一个设计原则就是:

“Standards compliant, fast, secure markdown processing library in C”

注意:GFM是支持部分HTML标签的,比如script, style, pre等

在GFM中插入公式的方法

1.最佳方案-Script+MathJax

MathJax是一个用于数学公式展示的JavaScript引擎,它支持几乎全部浏览器。

在GFM中,我们可以在Markdown文档的前部加入以下HTML标签:

<script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML" type="text/javascript"></script>

MathJax默认行内公式标记为”\\“,可以使用以下方法来支持”$”符号(注意将下面的代码加到上面代码之前):

<script type="text/x-mathjax-config">
  MathJax.Hub.Config({
    tex2jax: {
      inlineMath: [ ['$','$'], ["\\(","\\)"] ],
      processEscapes: true
    }
  });
</script>

2.使用外部网站来将公式渲染为图片

使用Google Chart的服务器

参考博客

使用方法:

<img src="http://chart.googleapis.com/chart?cht=tx&chl= 在此插入Latex公式" style="border:none;">

一个例子:

<img src="http://chart.googleapis.com/chart?cht=tx&chl=\Large x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}" style="border:none;">

公式显示结果为:

Google Chart服务器的响应速度还可以,但据说可能复杂一些的Latex公式可能无法解析。

使用forkosh服务器

参考博客

使用方法:

<img src="http://www.forkosh.com/mathtex.cgi? 在此处插入Latex公式">

一个例子:

<img src="http://www.forkosh.com/mathtex.cgi? \Large x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}">

公式显示结果为:


转载请注明原地址,魏鑫燏的博客: http://slowlythinking.github.io 谢谢!

打赏

关闭

感谢您的支持,我会继续努力!

扫码支持
扫码支持

打扫码打赏,请量力而行