1. 更换渲染引擎

由于hexo默认渲染器hexo-renderer-marked不支持mathjax渲染,可拓展性也相对较差,故此处选择基于Pandoc的渲染引擎hexo-renderer-pandoc进行替换

首先用npm卸载hexo-renderer-marked并安装hexo-renderer-pandoc

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

此外,由于hexo-renderer-pandoc依赖于Pandoc,所以在本地环境中也需要安装Pandoc

Pandoc项目地址:https://github.com/jgm/pandoc

安装完后使用如下命令确认安装

1
pandoc --version

Tips:如pandoc已经添加至环境变量但执行上述命令仍无输出,可以重启电脑或激活环境变量后再试

2. 修改主题配置文件

修改当前使用主题的主题配置文件,本文用的是butterfly,故修改根目录下的_config.butterfly.yml,将enable置为trueper_page按需修改

1
2
3
4
5
# MathJax
mathjax:
enable: true
# true时每一页都加载js渲染公式, false时只有当md文件头部font-matter含'mathjax: true'时才会加载js渲染公式
per_page: false

Tips:不同主题的配置文件不一致,需参阅主题的说明文档进行差异化配置

3. 测试

重新生成静态文件并测试

1
hexo clean && hexo g && hexo s