使用KaTeX编辑公式和化学方程式

最近在整理无机笔记的时候需要写方程式和数学公式,直接用符号输入还是比较困难的,而且并不美观,有很多式子也无法表示。所以研究了一下主题内置的KaTeX的使用。

写一篇post记录一下,作为备忘和速查表。

0 什么是KaTeX?

我们在网页中输入数学公式并不像在Word中使用公式编辑器那样方便,所以需要一些排版系统来帮助,例如LaTeX。而KaTeX是一个轻量级的支持HTML的数学引擎,可以实现网页上数学公式的渲染。它可以认为是LaTeX的一个子集。

还有另一个更为知名的数学引擎:MathJax,它的优势主要是渲染功能更全面,支持的公式渲染更多,但是缺点是大量公式的渲染速度慢。KaTeX的优点即是更加轻量化,渲染速度快,但是相比MathJax渲染功能少。就我个人而言,更多高级的公式我也用不到,KaTeX的渲染能满足我简单数学公式和化学方程式的编辑需求,所以选择应用KaTeX。

1 在Blog里开启KaTeX

我使用的主题是:Fluid。不同主题的开启方式会有不同。

首先在主题配置中开启LaTeX数学公式设置:

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

将数学引擎设置为KaTeX。

然后更改Markdown的渲染器,按照如下步骤:

1
2
3
npm uninstall hexo-renderer-marked --save
npm install hexo-renderer-markdown-it --save
npm install @traptitech/markdown-it-katex --save

在站点配置中添加:

1
2
3
markdown:
plugins:
- "@traptitech/markdown-it-katex"

最后执行:

1
hexo clean

即可在文章中使用KaTeX渲染数学公式。使用时需要在Front-matter中指定 math: true。例如:

1
2
3
4
5
title: 使用KaTeX编辑公式和化学方程式
date: 2022-12-04 12:06:05
tags: trifle
categories: 网络技术
math: true

2 KaTeX编辑公式的语法

有两篇比较不错的资料可供参考:

【原创】CSDN·Markdown·KaTex/LaTex 用法小全 - C20182030Epic

Supported Functions - KaTeX

同时摘录一些较重要内容以备速查:

基本方程式的输入:

1
2
$$ CaSiO_3(s) + 4HF(aq) \rightarrow SiF_4(g) + 2H_2O(l) $$
$$ 2Mn^{2+}(aq) + 5S_2O_8^{2-}(aq) + 24H_2O(l) \rightarrow 2MnO_4^- + 10SO_4^{2-}(aq) + 16H_3O^+(aq) $$

$$
CaSiO_3(s) + 4HF(aq) \rightarrow SiF_4(g) + 2H_2O(l)
$$

$$
2Mn^{2+}(aq) + 5S_2O_8^{2-}(aq) + 24H_2O(l) \rightarrow 2MnO_4^- + 10SO_4^{2-}(aq) + 16H_3O^+(aq)
$$

数学公式:

1
2
$$ [H_3O^+] = \frac {-K_a^ɵ + \sqrt {K_a^{ɵ2} + 4K_a^ɵ · c_0(HB)}}{2} $$
$$ E_r = \frac {x - μ}{μ} \times 100\% $$

$$
[H_3O^+] = \frac {-K_a^ɵ + \sqrt {K_a^{ɵ2} + 4K_a^ɵ · c_0(HB)}}{2}
$$

$$
E_r = \frac {x - μ}{μ} \times 100%
$$

基本上用到这些就够了,普化原理部分都是较为基础的公式,如果有需要再去查表即可。

不得不说渲染出来的结果确实挺好看的XD。


使用KaTeX编辑公式和化学方程式
http://argon-gas.top/p/35749.html
作者
Sun
发布于
2022年12月4日
许可协议