Hexo Fluid中渲染LaTeX数学公式

原生的md渲染器hexo-renderer-markdowed对复杂公式并不太友好,如果需要支持数学公式,需要换新的渲染器。Fluid主题内置LaTeX功能的,详见官网。但是我这里没有用官网的教程,用的是另一位大佬的博客文章。官网用的渲染器是hexo-renderer-markdown-it,他用的是hexo-renderer-markdown-it-plus,看其他人也是推荐这个,相对来说它会好很多,毕竟是plus嘛。这里也贴一下他的主页

也有其他人选择使用 MathJax,MathJax 虽然语法比较全,但加载会很慢,并且有些内联公式里面的转义字符\不太支持。KaTeX渲染很快,小部分语法例如equation、align等不支持,总的来数够用了。

设置如下:

更改Markdown渲染器

注意不能安装多个渲染器,这样会渲染多次,所以检查一下,这些都要删掉

1
2
npm un hexo-renderer-marked --save
npm un hexo-renderer-kramed --save

安装katex

1
npm i hexo-renderer-markdown-it-plus --save

如果想要更好的视觉体验,推荐安装hexo官方的hexo-math,让字体变得更好看

1
npm install hexo-math --save

修改hexo博客配置文件

修改hexo/_config.yml,在文末加入以下信息

1
2
3
4
5
6
7
8
9
math:
engine: katex
katex:
css: https://fastly.jsdelivr.net/npm/katex@0.10.0/dist/katex.min.css
js: https://fastly.jsdelivr.net/npm/katex@0.10.0/dist/katex.min.js
config:
# KaTeX config
throwOnError: false
errorColor: "#cc0000"

修改fluid主题配置文件

注意specific参数,自定义页面默认不加载渲染,在文章头中加入math: true才会启用公式渲染,

1
2
3
4
5
post:
math:
enable: true
specific: true
engine: katex

修改配置完成后,清除缓存并重启:

1
hexo clean && hexo s

查看渲染结果

行内公式: fw,b(x)=wx+bf w,b (x)=wx+b

行间公式

J(w,b)=12mmi=1(fw,b(x(i))y(i))2J(w,b)=\frac{1}{2m} \sum_{m}^{i=1}(f_{w,b}(x^{(i)})-y^{(i)} )^{2}


Hexo Fluid中渲染LaTeX数学公式
https://zhouyinglin.cn/post/97e4add3.html
作者
小周
发布于
2022年12月19日
更新于
2022年12月19日
许可协议