hexo支持mathjax

Posted 2021-01-03 shor

新博客：https://ylong765.github.io/Yinl-Blog/
欢迎关注，同步更新

技术博客有时避免不了一些数学公式，利用Hexo建立博客后，最开始利用Google的公式库，但是得请求Google的网址，有时会被墙，所以不得不转战方向。让Hexo自己支持mathjax必然是一个省心的过程。然而事实并不省心。如果要建立一个支持数学公式的基于Hexo框架的博客，你得符合以下要求：

• 博客：Hexo，博客的搭建可以看我之前的文章
• 支持mathjax的markdown渲染器：hexo-renderer-kramed
• 支持mathjax的Theme：NexT：(NexT使用文档，之前用的Archar，不过不支持mathjax)
• markdown编辑器：Typora

安装渲染器

hexo默认的渲染器是marked，并不支持mathjax。kramed是在marked基础上修改的，支持了mathjax。你的hexo工程目录下的node_modules中可以找到对应的渲染器文件夹。同时在你的工程目录下用以下命令安装kramed。另外补充一个NexT配置中推荐的渲染器hexo-renderer-pandoc，功能很强大不仅可以渲染markdown，还支持textile、reStructedText等许多其他格式。具体参见官方教程

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

如果你安装了hexo-math包，卸载再安装hexo-renderer-mathjax包

npm uninstall hexo-math --save
npm install hexo-renderer-mathjax --save

更新mathjax的CDN链接，打开node_modules/hexo-renderer-mathjax/mathjax.html

修改<scripts>标签

<script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-MML-AM_CHTML"></script>

NexT开启mathjax

打开主题的_config.yml文件，找到math字段，新版的NexT主题支持两个数学渲染引擎mathjax和katex，这里我们使用mathjax

math:
  enable: true
  // 省略很多注释
  engine: mathjax

文章中开启mathjax标签

为加快渲染速度，渲染器只会在标签中有mathjax: true的文章中使用利用mathjax渲染。例：

title: hexo支持mathjax
date: 2018-08-31 08:33:08
tags: [Web,hexo,mathjax]
mathjax: true // 开启后才会渲染数学公式

Typoare

Typoare原生支持数学公式的输入和渲染，而且还支持本地图片导入的图片复制位置。

然后开启你的Typoare编辑器输入几串公式，看看效果吧~