让hexo渲染MathJax复杂公式(默认的渲染引擎复杂公式会报错)
Problem
对复杂公式的支持不够好,简单公式可以显示,复杂编译错误,验证表明,问题不是mathjax.js导致,是默认hexo引擎编译导致html文本转义错误。
Reason
Hexo默认使用"hexo-renderer-marked"引擎渲染网页,该引擎会把一些特殊的markdown符号转换为相应的html标签,比如在markdown语法中,下划线'_'代表斜体,会被渲染引擎处理为<em>
标签
因为类Latex格式书写的数学公式下划线 '_' 表示下标,有特殊的含义,如果被强制转换为<em>
标签,那么MathJax引擎在渲染数学公式的时候就会出错。例如,x_i
在开始被渲染的时候,处理为x<em>i</em>
,这样MathJax引擎就认为该公式有语法错误,因为不会渲染。
类似的语义冲突的符号还包括'*', '{', '}', ''等。
Solution
- 更换默认的Hexo下 Markdown渲染引擎 marked -> kramed
npm uninstall hexo-renderer-marked --save
npm install hexo-renderer-kramed --save
- 更改hexo转义冲突
找到根目录
node_moduleskramedlibrulesinline.js
- 修改11行,取消对
,{,}
的转义escape // escape: /^\([\`*{}[]()#$ -.!_>])/, escape: /^\([`*[]()#$ -.!_>])/, - 修改20行em // em: /^b_((?:__|[sS]) ?)_b|^*((?:**|[sS]) ?)*(?!*)/, em: /^*((?:**|[sS]) ?)*(?!*)/,
- 修改11行,取消对
- 三连
hexo cl && hexo g && hexo s
查看效果 Debug - 如果出问题,在主题
_config.yml
下设置mathjax
为true
- 文章也要开启
mathjax
---
title: 我是标题
date: 2020-08-15 23:18:50
tags:
mathjax: true
--
其他解决办法
- 服务器端的渲染
- math.now.sh
- markdown-it-latex2img
SEO 搜索引擎优化
Google search console 大全