前言

因為最近的家教項目以數學為主，逃不掉寫算式的命運，故來設置。

為什麼用 KaTeX 而不是 MathJax 呢？因為聽說前者的渲染速度快了不下十倍，此處直接不踩雷，果斷聽從前輩建議。

設置

  • 與 MathJax 不兼容，若有配置需先禁用。

  • 修改 themes\butterfly\_config.yml，加入：

    1
    2
    3
    4
    katex:
      enable: true
      per_page: false
      hide_scrollbar: true
    • 其中 per_page 如果設定為 false，僅會在文章 front-matter 中有帶 katex: true 時會加載 KaTeX。

  • 接著卸載 marked 插件，安裝 hexo-renderer-markdown-it：

    1
    2
    3
    4
    5
    npm un hexo-renderer-marked --save # 如果有安裝這個的話，卸載
    npm un hexo-renderer-kramed --save # 如果有安裝這個的話，卸載

    npm i hexo-renderer-markdown-it --save # 需要安裝這個渲染插件
    npm install @neilsustc/markdown-it-katex --save #需要安裝這個katex插件

  • 接著設置 _config.yml：

    1
    2
    3
    4
    5
    6
    markdown:
      plugins:
        - plugin:
          name: '@neilsustc/markdown-it-katex'
          options:
            strict: false

使用

  • 使用時，注意如果沒有開啟 per_page，要在文章 front-matter 中加入 katex: true。

  • 然後就可以使用咯。

  • 比如說$\displaystyle\sum_{n=1} ^{\infty} a_i x^i$，就會顯示出：

    ∑n=1∞aixi\displaystyle\sum_{n=1} ^{\infty} a_i x^i