Upd2019.10.19:以适配新版本的hexo-renderer-markdown-it-plus
Upd2019.12.11:一些复杂公式的渲染问题可以在katex.org上进行测试,如果katex.org上无法正常渲染且您的TeX源码无语法错误的话,请与 KaTeX 的开发者联系。
随着Material-X的使用用户越来越多、使用用户的范围越来越广。不少用户被如何在Material-X上渲染公式所困。xaoxuu给出的方案是完美的,你只需要在使用最新的版本下将文章开头加入一行mathjax: true
即可,十分简洁,可以渲染绝大部分简单的公式。
注:本文部分素材来自网络,相关插件来源github。
存在的问题
至于有一些复杂的公式为什么渲染不了,大概是有几种 的符号与markdown冲突,在渲染时就会转义错误。错误通常会直接导致无法生成。
操作原理
具体的解决方案是卸载掉原来的渲染器,安装一个针对 优化过的渲染器。
这个渲染器包括了 。
具体操作步骤
卸载原有的渲染器,并安装大神的渲染器(基本稳定可靠)
1 | npm uninstall hexo-renderer-marked --save |
在根目录的配置文件_config.yml
加入
此为历史版本
1 | plugins: |
此为更新后版本
1 | markdown_it_plus: |
至此,你在Material-X下就可以成功使用 渲染公式了。
如果失败,尝试继续进行以下操作:
找到/themes/material-x/layout/_partial/head.ejs
在该文件最后加入一行
此为历史版本
1 | <link href="https://cdn.bootcss.com/KaTeX/0.7.1/katex.min.css" rel="stylesheet"> |
此为更新后版本
1 | <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.11.1/dist/katex.min.css" integrity="sha384-zB1R0rpPzHqg7Kpt0Aljp8JPLqbXI3bhnPWROx27a9N0Ll6ZP/+DiW/UqRcLbRjq" crossorigin="anonymous"> |