1.1 默认渲染器的局限#

Hexo 默认使用 hexo-renderer-marked 作为 Markdown 渲染器，但它存在以下问题：

• 不支持 $ 语法：会将 $ 当作普通字符处理
• 符号冲突：_（下划线）会被解析为斜体，破坏公式结构
• 转义问题：\\ 等 LaTeX 转义符可能被错误处理

1.2 Fluid 主题数学公式支持#

Fluid 主题内置了 MathJax 和 KaTeX 的支持，但：

• 默认是关闭状态（math.enable: false）
• 需要配合支持数学公式的 Markdown 渲染器使用

2.1 更换 Markdown 渲染器#

卸载默认渲染器，安装 hexo-renderer-markdown-it 及数学公式插件：

1
# 卸载默认渲染器
2
npm uninstall hexo-renderer-marked
3

4
# 安装新渲染器和 MathJax 插件
5
npm install hexo-renderer-markdown-it markdown-it-mathjax3 --save

2.2 配置渲染器#

在 Hexo 根目录的 _config.yml 中添加：

1
# Markdown 渲染器配置 (markdown-it)
2
markdown:
3
  preset: 'default'
4
  render:
5
    html: true
6
    xhtmlOut: false
7
    langPrefix: 'language-'
8
    breaks: true
9
    linkify: true
10
    typographer: true
11
  plugins:
12
    - markdown-it-mathjax3

配置项说明：

2.3 开启 Fluid 数学公式功能#

在 _config.fluid.yml（主题覆盖配置）中添加：

1
post:
2
  math:
3
    enable: true      # 开启数学公式
4
    specific: false   # false=全局生效，true=需在文章front-matter指定
5
    engine: mathjax   # 渲染引擎：mathjax 或 katex

MathJax vs KaTeX 对比：

2.4 重新生成网站#

1
hexo clean && hexo g && hexo s

3.1 行内公式#

使用单个 $ 包围：

1
爱因斯坦质能方程：$E = mc^2$

效果：爱因斯坦质能方程：$E = mc^2$

3.2 块级公式#

使用双 $$ 包围：

1
$$
2
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
3
$$

效果：

3.3 常用公式示例#

求和公式：

矩阵：

分段函数：

希腊字母与运算符：

4.1 修改配置#

1
post:
2
  math:
3
    enable: true
4
    specific: true   # 改为 true
5
    engine: mathjax

4.2 在文章中启用#

在需要公式的文章 Front-matter 中添加：

1
---
2
title: 我的数学笔记
3
math: true
4
---

Q1: 公式不渲染，显示原始代码#

可能原因：

1. 未安装 markdown-it-mathjax3 插件
2. _config.yml 中未配置 plugins
3. Fluid 主题的 math.enable 未开启

解决： 检查上述三个配置是否正确。

Q2: 下划线 _ 导致公式错误#

原因： Markdown 将 _ 解析为斜体

解决：

• 使用 \_ 转义
• 或确保使用了 markdown-it-mathjax3 插件（它会正确处理数学环境中的下划线）

Q3: 公式在首页显示，但文章页不显示#

原因： 可能是缓存问题

解决：

1
hexo clean && hexo g

Q4: 想用 KaTeX 代替 MathJax#

步骤：

1. 安装 KaTeX 插件：npm install @vscode/markdown-it-katex --save
2. 修改 _config.yml 的 plugins
3. 修改 Fluid 配置：engine: katex