hexo增加数学公式的支持

前言

由于写markdown文章很多地方都需要用到latex语法展示数学公式,有道云笔记本身就支持(解析器为katex),但是hexo默认是不支持的,因此会导致有道云笔记markdown导出到hexo博客时,数学公式就是一堆普通字符串。

不过好在已经有人造出了在hexo中支持数学公式的轮子,废话不多说,直接上方法;

使用NexT主题时

由于NexT主题本身就带有支持解析数学公式的配置,直接按照相关文档配置即可,十分方便!

不过有些地方需要注意:

  • 由于主题可能一直在更新,导致github上面的文档中具体的配置与我们自己用的版本不太一致;直接升级有可能会遇到其它意想不到的问题,所以最好直接查看本地项目next/docs/zh-CN/MATH.md文件即可,这里面的配置跟我们使用的主题版本是一致的。

  • 同上,KaTex的版本也一直在更新,最好将相应的CDN地址替换成最新版本的,以免采坑。

使用hexo-math插件

当时最初在网上找到的方法就是建议采用hexo-math插件来支持数学公式,而且这个插件是hexo官方维护的;然而,根据其官方文档的步骤来配置,你会发现数学公式压根不会解析!!!原因就在于它压根就没提需要更换markdown渲染引擎的事情……

这是个巨坑,可能会浪费很多时间;对应的渲染引擎跟NexT配置提到的一样,需要根据使用MathJax还是KaTex来分别选择。

相关文档