Hexo NexT 主题启用 LaTeX

$L^AT_EX$ 是一种基于 $T_EX$ 的排版系统,利用这种格式,可以迅速生成复杂表格和数学公式等,对于我们写博客帮助十分大。

版本

NexT 不同版本可能配置文件和支持的插件有所不同,所以先附上本站所用 Hexo 与 NexT 版本信息:

1
2
Hexo: 3.7.0
NexT: 6.0.3

MathJax 插件

有些 Hexo 主题自带 MathJax 插件,例如 NexT

如果没有的话,可以手动安装:

1
npm install hexo-math --save

启用

NexT 主题的 MathJax 插件默认是禁用的:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# Math Equations Render Support
math:
enable: false

# Default(true) will load mathjax/katex script on demand
# That is it only render those page who has 'mathjax: true' in Front Matter.
# If you set it to false, it will load mathjax/katex srcipt EVERY PAGE.
per_page: true

engine: mathjax
#engine: katex

# hexo-rendering-pandoc (or hexo-renderer-kramed) needed to full MathJax support.
mathjax:
# Use 2.7.1 as default, jsdelivr as default CDN, works everywhere even in China
cdn: //cdn.jsdelivr.net/npm/mathjax@2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML
# For newMathJax CDN (cdnjs.cloudflare.com) with fallback to oldMathJax (cdn.mathjax.org).
#cdn: //cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML
# For direct link to MathJax.js with CloudFlare CDN (cdnjs.cloudflare.com).
#cdn: //cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-MML-AM_CHTML
# For automatic detect latest version link to MathJax.js and get from Bootcss.
#cdn: //cdn.bootcss.com/mathjax/2.7.1/latest.js?config=TeX-AMS-MML_HTMLorMML

# hexo-renderer-markdown-it-plus (or hexo-renderer-markdown-it with markdown-it-katex plugin)
# needed to full Katex support.
katex:
# Use 0.7.1 as default, jsdelivr as default CDN, works everywhere even in China
cdn: //cdn.jsdelivr.net/npm/katex@0.7.1/dist/katex.min.css
# CDNJS, provided by cloudflare, maybe the best CDN, but not works in China
#cdn: //cdnjs.cloudflare.com/ajax/libs/KaTeX/0.7.1/katex.min.css
# Bootcss, works great in China, but not so well in other region
#cdn: //cdn.bootcss.com/KaTeX/0.7.1/katex.min.css

enable 的值改为 true 即可启用 MathJax。

同时注意 per_page 上面的注释,注释表明了,MathJax 只渲染在文件前端注明 mathjax: true 字段的文章,例如:

1
2
3
4
5
6
7
8
9
10
---
title: Hexo NexT 主题启用 LaTeX
copyright: true
mathjax: true
date: 2018-04-11 12:37:33
categories: Hexo
tags:
- Hexo
- LaTeX
---

效果

行内公式:

1
这是一个行内公式:$sin^2\theta + cos^2\theta = 1$

效果:

这是一个行内公式:$sin^2\theta + cos^2\theta = 1$

整行公式:

1
$$sin^2\theta + cos^2\theta = 1$$

效果:

$$sin^2\theta + cos^2\theta = 1$$

整行非斜体公式:

1
2
3
$$\sin^2\theta + \cos^2\theta = 1$$
或者
$$\rm sin^2\theta + cos^2\theta = 1$$

效果:

$$\sin^2\theta + \cos^2\theta = 1$$

$$\rm sin^2\theta + cos^2\theta = 1$$

编辑

让 Hexo 支持 $L^AT_EX$ 后我们还需要一个编辑器来实时预览 Markdown+LaTeX,推荐 VS Code 搭配 Markdown+Math

LaTeX 符号表

LaTeX 支持众多的符号,我们不可能完全记下来,这里有一份简单常用的符号说明:常用数学符号的 LaTeX 表示方法

还有一份 PDF 版的 LaTeX 介绍:一份不太简短的 LATEX2$\epsilon$ 介绍

-------------本文结束感谢阅读-------------
  • 本文标题:Hexo NexT 主题启用 LaTeX
  • 本文作者:xlui
  • 发布时间:2018年04月11日 - 12:04
  • 最后更新:2023年01月20日 - 01:01
  • 本文链接: https://xlui.me/t/hexo-latex/
  • 版权声明: 本博客所有文章除特别声明外,均采用 CC BY-NC-ND 4.0 许可协议。转载请注明出处!