Skip to content

設定數學式

在 Material for MkDocs 中，要做如下的設定才會秀出正確的數學方程式。

⚙️ 設定

在docs/javascripts中加入：

mathjax.js
window.MathJax = {
  tex: {
    inlineMath: [["\\(", "\\)"]],
    displayMath: [["\\[", "\\]"]],
    processEscapes: true,
    processEnvironments: true
  },
  options: {
    ignoreHtmlClass: ".*|",
    processHtmlClass: "arithmatex"
  }
};

document$.subscribe(() => { 
  MathJax.startup.output.clearCache()
  MathJax.typesetClear()
  MathJax.texReset()
  MathJax.typesetPromise()
})

並在mkdocs.yml中加入如下設定：

markdown_extensions:
  - pymdownx.arithmatex:
      generic: true

extra_javascript:
  - javascripts/mathjax.js
  - https://unpkg.com/mathjax@3/es5/tex-mml-chtml.js

🖥️ 測試

如果要獨立顯示數學公式，使用區塊語法 $$...$$ 或 \[...\]，方程式通常會另起一行並置中顯示。 。

區塊語法 (Block Syntax)
這是區塊公式：

$$
\int_0^1 x^2 \,dx = \frac{1}{3}
$$

這是區塊公式：

\[ \int_0^1 x^2 \,dx = \frac{1}{3} \]

如果要在文本段落內插入數學公式，使用行內語法 $...$ 或 \(...\)，方程式通常不會換行。

行內語法 (Inline Syntax)
這是行內公式 $E = mc^2$。

這是行內公式 \(E = mc^2\)。

📝 參考資料