Hexo 博客添加数学支持

$e^{i\pi} = -1$

数学支持对于个人博客来说我觉得至关重要，但是默认的 Hexo 渲染 Markdown 的引擎 hexo-render-marked 却不支持。本文讲述如何通过更换 Hexo 的 Markdown 渲染引擎的方式让你的博客支持数学。

警告：在开始本指南之前，请确保您位于 hexo 主目录中。

默认的 Hexo 安装将包括一个使用 marked 的 Markdown renderer（渲染器）插件，因此如果要更换，例如更换成本教程使用的 hexo-renderer-markdown-it ，你应该先卸载它。

$ npm un hexo-renderer-marked --save

如果您已经删除了默认 renderer 以及您可能添加的其他 renderer，现在可以安全地安装 hexo-renderer-markdown-it

$ npm i hexo-renderer-markdown-it --save

安装 markdown-it 数学插件：

$ npm install katex @renbaoshuo/markdown-it-katex

在 _config.yml 中添加下列配置：

markdown:
  preset: "default"
  render:
    html: true
    xhtmlOut: false
    langPrefix: "language-"
    breaks: true
    linkify: true
    typographer: true
    quotes: "“”‘’"
  enable_rules:
  disable_rules:
  plugins:
    - name: "@renbaoshuo/markdown-it-katex"
      options:
        skipDelimitersCheck: true
  anchors:
    level: 2
    collisionSuffix: ""
    permalink: false
    permalinkClass: "header-anchor"
    permalinkSide: "left"
    permalinkSymbol: "¶"
    case: 0
    separator: "-"
  images:
    lazyload: false
    prepend_root: false
    post_asset: false
  inline: false # https://markdown-it.github.io/markdown-it/#MarkdownIt.renderInline

可选的，你可能需要去你的主题设置里，添加 KaTeX 样式表：

<link
  rel="stylesheet"
  href="https://cdn.jsdelivr.net/npm/katex/dist/katex.min.css"
/>

关于 hexo-renderer-markdown-it 的其他说明，请参考 https://github.com/hexojs/hexo-renderer-markdown-it