The fastest math typesetting library for the web.

Katex

在网页中如何插入公式？如 $x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}$

一个办法是图片，但是极不方便，最好的办法还是用文字来描述数学公式，把渲染的工作交给引擎。LaTeX就是一个常用的排版工具，包括但不限于数学公式、表格、化学公式，而我们更多的需求是展示数学公式，所以只需要一个LaTeX的子集，能渲染数学公式即可，KaTeX就是这样一个支持HTML的轻量级的数学公式引擎。

文件配置

  1. 打开主题配置文件_config.butterfly.yml，禁用MathJax，并修改 KaTeX

     1# MathJax
 2mathjax:
 3  enable: false
 4  per_page: false
 5
 6# KaTeX
 7katex:
 8  enable: true # false 需要時加載，須在使用的Markdown Front-matter 加上 katex: true
 9  per_page: false
10  hide_scrollbar: true

  2. 卸載掉marked或者kramed插件，安裝hexo-renderer-markdown-it，可以在package.json文件中查看。

    1npm un hexo-renderer-marked --save # 卸载 marked 插件
2npm un hexo-renderer-kramed --save # 卸载 kramed 插件
3npm i hexo-renderer-markdown-it --save # 安装渲染插件
4npm install katex @renbaoshuo/markdown-it-katex # 安装渲染插件

  3. 在hexo的根目录的_config.yml中配置

    1markdown:
2  plugins:
3    - plugin:
4      name: "@renbaoshuo/markdown-it-katex"
5      enable: true
6      options:
7        strict: false # 禁用掉 KaTeX 在命令行上输出的宂长的警告信息

  4. 配置成功后，在需要渲染的文章开头，添加参数 katex: true 即可