A Rust pre-processor for mdBook, converting Latex equations to HTML at compile time. This preprocessor uses the Katex crate; see this page for the list of supported Latex functions.
Install the crate
cargo install mdbook-katex
Add the Katex preprocessor to your book.toml
file
toml
[preprocessor.katex]
You can then 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 defined in a .txt
file, according to the following pattern
txt
\grad:{\nabla}
\Rn:{\mathbb{R}^n}
Then, specify the macros location in your book.toml
toml
[preprocessor.katex]
macros = "path/to/macros.txt"
You can now use these macros in any .md
file
```
$$ \grad f(x) \in \Rn $$ ```