feat(mkdocs): math equations

Author: kiyoon

docs/javascripts/mathjax.js

@@ -0,0 +1,19 @@
+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()
+})

docs/mkdocs/mkdocs.md

@@ -77,3 +77,15 @@ graph LR
   D --> B;
   B ---->|No| E[Yay!];
 ```
+
+### Math Equations with LaTeX syntax
+
+$a^2 + b^2 = c^2$
+
+$$
+\begin{align*}
+\dot{x} & = \sigma(y-x) \\
+\dot{y} & = \rho x - y - xz \\
+\dot{z} & = -\beta z + xy
+\end{align*}
+$$

mkdocs.yml

@@ -123,3 +123,10 @@ markdown_extensions:
   - pymdownx.tilde # strikethrough with ~~ ~~
   - toc:
       permalink: true
+  # MathJax
+  - pymdownx.arithmatex:
+      generic: true
+
+extra_javascript:
+  - javascripts/mathjax.js
+  - https://unpkg.com/mathjax@3/es5/tex-mml-chtml.js