A Preprocessor for mdbook, converting Latex equations to html at compile time. This preprocessor uses the katex crate; see this page for supported Latex functions.
First, install the crate
cargo install mdbook-katex
Then, add the KaTex preprocessor to your book.toml file
toml
[preprocessor.katex]
command = "mdbook-katex"
Once this is done, you can use KaTex expressions within your .md files, using $ and $$ delimiters. Use \$ for a regular dollar symbol.
```
Here is an inline example, $ \pi(\theta) $,
An equation:
$$ \nabla f(x) \in \mathbb{R}^n $$
And a regular $ symbol. ```
Macros with no arguments are supported. They must be specified in a .txt file, according to the following pattern
txt
\grad:{\nabla}
\Rn:{\mathbb{R}^n}
Then, change the preprocessor command in your book.toml to tell it where the macros are located
toml
[preprocessor.katex]
command = "mdbook-katex --macros=path/to/macros.txt"
You can now use these macros in any .md file.
```
$$ \grad f(x) \in \Rn $$ ```