在markdown里如何写数学公式

2017-03-02

最近准备写一下机器学习的一些学习笔记，由于涉及到大量数学公式，发现不把如何在markdown里写数学公式这个问题解决了会严重影响工作效率。大概而言，主要有两种方式：

用图片！
也就是编辑好公式，上传，然后在markdown里面引用图片链接的方式。这种方式方便直接，但是显得比较low一点。有兴趣的可以参考这几篇文章。

http://www.ruanyifeng.com/blog/2011/07/formula_online_generator.html
当然，在某些情况下，必须使用这种思路。比如，微信公众号里。可以参考这里

用Mathjax插件来写LaTex公式。
哪怕你是用图片，那也得写出LaTex公式啊。所以我们今天主要讲第二种方式。推荐这个工具，可以直接在浏览器里手写公式，它会帮你转为LaTex！很好很强大。

MathJax插件

著名的Stackoverflow网站上的漂亮公式，就是使用了MathJax插件的效果。添加MathJax插件也非常简单，只需要在markdown文件中，添加MathJax CDN，如下：

1
2
3

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

就可以在md文件中插入Tex格式的公式了。

行间公式的形式为

1	$$ 此处插入公式 $$

而行内公式的形式为

1	\$ 此处插入公式 \$

Hexo中显示数学公式

Hexo原生不支持数学公式，因此需要我们做一些修改。安装hexo-math插件：

1	npm install hexo-math --save

在_config.yml中增加

1 2	plugins: hexo-math

完事大吉，你现在可以写LaTex公式了，我们来写几个看看。

这是行内公式根号2这样写: $\sqrt{2}$

1	\$\\sqrt{2}\$

这是单独一行的公式:

1
2
3

$$ a ^ 2 + b ^ 2 = c ^ 2 $$
$$ \sqrt{2} $$
$$ evidence\_{i}=\sum \_{j}W\_{ij}x\_{j}+b\_{i} $$

$$ a ^ 2 + b ^ 2 = c ^ 2 $$
$$ \sqrt{2} $$
$$ evidence_{i}=\sum _{j}W_{ij}x_{j}+b_{i} $$
细心的同学会发现，里面有很多\\, \_之类，原因是\本身在markdown和LaTex里都有含义，因此需要转义。但是LaTex里面， \太常用了，所以每次遇到都转义的话就很痛苦，而且在hexo里面写的公式，复制到其他地方去就不支持了。

网上有改hexo渲染的源码的，有换用pandoc的，其实最简单的方式是用hexo-math里的tag。网上搜索到的很多资料都是用的{% math_block %}，我试了发现总是不对，后来看官网，发现这个方法已经deprecated了，最新的用{% math %}，如下：

1	这是行内公式：{% math %}\sqrt{2 + 3}{% endmath %}

显示为：这是行内公式：$\sqrt{2 + 3}$
一行公式：

$$ evidence\_{i}=\sum \_{j}W\_{ij}x\_{j}+b\_{i} $$
{% math %}
\begin{aligned}
evidence_{i}=\sum _{j}W_{ij}x_{j}+b_{i}
\end{aligned}
{% endmath %}

$$ evidence_{i}=\sum _{j}W_{ij}x_{j}+b_{i} $$
$$\begin{aligned} evidence_{i}=\sum _{j}W_{ij}x_{j}+b_{i} \end{aligned}$$
可以看出，如果有需要转义的字符，用{% math %}tag这种方式要好很多。

再来一个复杂点的公式，这是word2vec的损失函数公式（选中公式，右键可以查看LaTex源码）：

{% math %}
J_\text{NEG} = \log Q_\theta(D=1 |w_t, h) +
  k \mathop{\mathbb{E}}_{\tilde w \sim P_\text{noise}}
     \left[ \log Q_\theta(D = 0 |\tilde w, h) \right]
{% endmath %}

$$J_\text{NEG} = \log Q_\theta(D=1 |w_t, h) + k \mathop{\mathbb{E}}_{\tilde w \sim P_\text{noise}} \left[ \log Q_\theta(D = 0 |\tilde w, h) \right]$$

经过简单的配置，我们的web页面已经可以支持很方便的书写数学公式了，而且由于不用特殊转义，这里写的LaTex可以在其他markdown环境下使用，比如有道云笔记。

============update===========

刚发现由于引用了MathJax.js，本身又会引用其他一些js、css以及font，会多增加差不多100k资源，并且由于都是国外的cdn，速度受限制（貌似还要翻墙），所以比较影响阅读体验。后续再想办法优化吧。

============update===========
发现next主题好看一些，换成了next。看到next直接支持MathJax的，换成了qiniu的cdn。但是next自带的math，不能支持{% math %}，发现还是需要hexo-math，而且很奇怪的是，发现不用在_config.yml里面写

1 2	plugins: hexo-math

居然也可以，只要package.json里面有hexo-math就可以了。于是参考hexo-math官网，换成了qiniu的cdn。

math:
  engine: 'mathjax' # or 'katex'
  mathjax:
  src: //cdn.staticfile.org/mathjax/2.7.0/MathJax.js?config=TeX-AMS-MML_HTMLorMML

奇怪的是，还是有一个网络请求，不知道从哪里来的。

1	https://cdn.mathjax.org/mathjax/contrib/a11y/accessibility-menu.js?V=2.7.0

而且说的

1	Your config will be merged into default config:

似乎也没有。生成的代码为

1
2
3

<script type="text/x-mathjax-config">
  MathJax.Hub.Config("");
</script>

配置目没有了？！！好在似乎没有影响使用，那就先暂时这样用着吧~~

[Refs]