✨ feat: add KaTeX support

content/blog/markdown.md

@@ -1,13 +1,31 @@
 +++
 title = "Markdown examples"
 date = 2023-01-31
-updated = 2023-03-01
+updated = 2023-04-15
 description = "This post showcases some examples of Markdown formatting, including a table, code blocks and tags, quotes, tables, and footnotes."
 
 [taxonomies]
 tags = ["markdown", "showcase"]
+
+[extra]
+katex = true
 +++
 
+## KaTeX
+
+[KaTeX](https://katex.org/) is a fast and easy-to-use library that enables the rendering of mathematical notation, using LaTeX syntax.
+
+You can use KaTeX **inline** by wrapping the expression between `$` or between `\\(` and `\\)`.
+
+For example, `$ \sin(x) = \sum_{n=0}^{\infty} \frac{(-1)^n}{(2n + 1)!} x^{2n + 1} $` would render: $ \sin(x) = \sum_{n=0}^{\infty} \frac{(-1)^n}{(2n + 1)!} x^{2n + 1} $
+
+To display the expression **on its own line and centered**, wrap it around `$$` or between `\\[` and `\\]`.
+
+For example, `\\[ r = \frac{\sum_{i=1}^{n}(x_i - \bar{x})(y_i - \bar{y})}{\sqrt{\sum_{i=1}^{n}(x_i - \bar{x})^2}\sqrt{\sum_{i=1}^{n}(y_i - \bar{y})^2}} \\]` renders: \\[ r = \frac{\sum_{i=1}^{n}(x_i - \bar{x})(y_i - \bar{y})}{\sqrt{\sum_{i=1}^{n}(x_i - \bar{x})^2}\sqrt{\sum_{i=1}^{n}(y_i - \bar{y})^2}} \\]
+
+To activate KaTeX for a post, include `katex = true` within the `[extra]` section of the post's front matter. For enhanced performance and security, the JavaScript, CSS, and fonts are hosted locally.
+
+**Note**: After enabling KaTeX, if you want to use \$ without rendering a mathematical expression, escape it with a single backslash: `\$`.
 
 ## Table
 
@@ -20,7 +38,6 @@ Here's an example of a table[^1]. Its colours change depending on the current th
 | Fe      | Iron    | 26            |
 | Au      | Gold    | 79            |
 
-
 ## Code Block
 
 ```rust