2025-06-08 NexT 主題的數學公式渲染器 (MathJax) 沒有正確開啟

2025-06-08 NexT 主題的數學公式渲染器 (MathJax) 沒有正確開啟

你的數學符號 $\overrightarrow{AO} = r \overrightarrow{AB} + s \overrightarrow{AC}$ 沒有在 Hexo 網站上正確顯示，通常不是打錯，而是 NexT 主題的數學公式渲染器 (MathJax / KaTeX) 沒有正確開啟。

---

✅ 該怎麼檢查？

你在 _config.next.yml（不是 _config.yml）裡面已經有一段：

math:
  enable: true
  mathjax:
    enable: true
    tags: none

這表示你用的是 MathJax，理論上 Hexo 生成時就應該支援 $$...$$ 或 $...$ 的數學公式。

---

🔍 可能的原因

1. Markdown 渲染器不支援內嵌公式

   • 如果你用的渲染器是 hexo-renderer-marked，它有時候和 MathJax 衝突。

   • NexT 官方推薦用：

     npm uninstall hexo-renderer-marked
     npm install hexo-renderer-markdown-it-plus --save

2. 公式語法問題

   • $...$（單個 $）有時會被當作普通字元，最好改成：

     • 行內公式：\(...\) 或 \( \overrightarrow{AO} = r \overrightarrow{AB} + s \overrightarrow{AC} \)

     • 區塊公式：

       $$
       \overrightarrow{AO} = r \overrightarrow{AB} + s \overrightarrow{AC}
       $$

3. 快取問題

   • NexT 有快取功能，記得清除快取再重建：

     hexo clean
     hexo g
     hexo s

---

✅ 建議解法

1. 確認 _config.next.yml 有：

   math:
     enable: true
     mathjax:
       enable: true

2. 確認你文章裡公式用 $$...$$ 區塊，不要只用單 $。

3. 如果還是不行，建議換渲染器：

   npm uninstall hexo-renderer-marked
   npm install hexo-renderer-kramed --save

   或者

   npm install hexo-renderer-markdown-it --save

---