Hexo Fluid主题配置 Latex 数学公式渲染

一、问题

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

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

二、解决

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

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

2.1 更换 Markdown 渲染器

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

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

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

2.2 配置渲染器

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

# Markdown 渲染器配置 (markdown-it)
markdown:
  preset: 'default'
  render:
    html: true
    xhtmlOut: false
    langPrefix: 'language-'
    breaks: true
    linkify: true
    typographer: true
  plugins:
    - markdown-it-mathjax3

2.3 开启 Fluid 数学公式功能

在 theme/Fluid/_config.yml 中修改：

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

如果要用 katex 代替 mathjax 可以参考如下：

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

2.4 完成配置

然后可以进行验证：

hexo cl & hexo g & hexo s