Skip to main content
  1. Posts/

Hexo 书写 LaTeX 公式时的一些问题及解决方法

··1169 words·3 mins·
Blog Hexo LaTeX NexT Markdown MathJax Pandoc
Table of Contents

在写作博文的时候,有时候需要输入一些数学公式,如果公式过长,我们通常希望把方程分成多行显示,在 LaTeX 中,我们可以使用 aligned 环境来书写多行公式,但是写出来的 Markdown 经过 Hexo 的处理以后显示不正确,原因何在?原来这与 Hexo 的渲染引擎有关系。

开启公式支持
#

Hexo 的自带的 Markdown 引擎并不支持 LaTeX 公式。 但是 MathJax 支持,因此首先要启用 MathJax 才能渲染 LaTeX 公式。如果你已经安装了 NexT theme,开启 MathJax 支持非常容易,在最新版的NexT 主题的 _config.yml 文件里,找到 MathJax 相关部分,使用以下配置,

math:
  enable: true
  # Default(true) will load mathjax/katex script on demand
  # That is it only render those page who has 'mathjax: true' in Front Matter.
  # If you set it to false, it will load mathjax/katex srcipt EVERY PAGE.
  per_page: false
  engine: mathjax

但是,由于 LaTeX 中的一些符号在 Markdown 也中有特殊含义,例如 两个 _ 在 Markdown中用来表示斜体(italic),因此两者的配合使用会产生一些问题。

从一个例子说起
#

假如我们想要显示下面的方程,

如果使用如下的 LaTeX 代码

\begin{align}
x &= a +b+c+d\\
 &= e +f\\
 &= g
\end{align}

使用 Hexo 渲染以后,得到的结果如下图所示,

可以看到,换行并未起作用,这是因为 Hexo 对 Markdown 文件的处理实际上分为两个步骤:

  1. Hexo 中的 Markdown 引擎把 Markdown 变为 html 文件
  2. MathJax 负责解释 html 的数学公式

第一步中,由于 backslash 在 Markdown 属于特殊字符,用于字符转义,所以两个 backslash 经过 Markdown 引擎处理,只剩下一个,等到 MathJax 引擎处理时,实际上 MathJax 只看到一个 backslash,MathJax 把它当作 LaTeX 中的空格,因此我们见到了上图所示的渲染结果。

知道了渲染错误的原因,解决办法也很简单,就是用四个 backslash 代替两个 backslash,确保 MathJax 的引擎看到的是两个 backslash,也就是把上述代码变成

\begin{align}
x &= a +b+c+d\\\\
 &= e +f\\\\
 &= g
\end{align}

这时产生的公式如下图所示,

如果想要去掉公式的编号,在 LaTeX 中,我们通常会选择加星号的 align 环境,但是注意到星号 (star)在 Markdown 也有特殊含义(一对单星号表示斜体,一对双星号表示粗体),因此必须对星号进行转义,才能确保 MathJax 见到星号,正确的代码是

\begin{align\*}
x &= a +b+c+d\\\\
 &= e +f\\\\
 &= g
\end{align\*}

如果按照上面的方法在 Markdown 文件中写公式,我们将会十分痛苦,并且写出来的 LaTeX 公式不能被标准的 LaTeX 处理引擎识别,因此这个解决办法是非常糟糕的解决办法。有没有更好的办法?答案是:有的!

解决方法
#

我试用了多款号称能够解决这个问题的 hexo renderer,例如 hexo-renderer-markdown-it-plus 以及 hexo-math,效果都差强人意。最后发现使用 hexo-renderer-pandoc 十分靠谱。使用这个 renderer 之前请确保你已经安装了Pandoc,然后卸载 Hexo 自带的 renderer,安装 Pandoc renderer:

npm uninstall hexo-renderer-marked --save
npm install hexo-renderer-pandoc --save

注意事项
#

如果你使用这款 Pandoc renderer,那么书写 Markdown 时候需要遵循 Pandoc 对 Markdown 的规定

有一些比较明显的需要注意的事项:正常的文字后面如果跟的是list, table或者quotation,文字后面需要空一行,如果不空行,这些环境将不能被 Pandoc renderer 正常渲染。

另外,文中的 URL 使用 Pandoc 渲染以后是普通的文本格式,不能点击,可以通过用<> 包围 URL 的方式把 URL 变成可点击的 URL。


参考
#

Related

把博客从 Hexo 迁移到 Hugo
··3194 words·7 mins
Blog Hugo Hexo MathJax LaTeX Pandoc Markdown
LaTeX Equation Numbering Done Right in Hexo
··678 words·4 mins
Blog Hexo LaTeX MathJax NexT Markdown
How to Install Hexo and Theme NexT from Scratch on Windows
··1218 words·6 mins
Blog Markdown NexT Hexo LaTeX Pandoc