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.
First, install the crate
cargo install mdbook-katex
Then, add the KaTex preprocessor to your book.toml
file
toml
[preprocessor.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 defined in a .txt
file, according to the following pattern
txt
\grad:{\nabla}
\Rn:{\mathbb{R}^n}
Then, specify the macros location in 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 $$ ```