diff --git a/guide/src/format/mathjax.md b/guide/src/format/mathjax.md index 3dd79215..3f9aa967 100644 --- a/guide/src/format/mathjax.md +++ b/guide/src/format/mathjax.md @@ -3,14 +3,6 @@ mdBook has optional support for math equations through [MathJax](https://www.mathjax.org/). -To enable MathJax, you need to add the `mathjax-support` key to your `book.toml` -under the `output.html` section. - -```toml -[output.html] -mathjax-support = true -``` - >**Note:** The usual delimiters MathJax uses are not yet supported. You can't currently use `$$ ... $$` as delimiters and the `\[ ... \]` delimiters need an extra backslash to work. Hopefully this limitation will be lifted soon. @@ -41,3 +33,64 @@ you would write: ```bash \\[ \mu = \frac{1}{N} \sum_{i=0} x_i \\] ``` + +## MathJax 2 + +To enable MathJax 2, you need to add the `mathjax-support` key to your `book.toml` +under the `output.html` section. + +```toml +[output.html] +mathjax-support = true +``` + +## MathJax 3 + +To enable MathJax 3, you need to add the `enable` key to your `book.toml` +under the `output.html.mathjax` section. + +```toml +[output.html.mathjax] +enable = true +``` +>**Note:** Remove or set to the `false` value the `mathjax-support` key +> under the `output.html` section if you set it previously. + +Additionaly you can set `config` key to select used [configuration][comb-comp]. +You can select one of: + +| Value | Input | Output | Default +| :-- | :-- | :-- | :-- +| tex-chtml | tex | chtml | +| tex-chtml-full | tex | chtml | +| tex-svg | tex | svg | +| tex-svg-full | tex | svg | +| tex-mml-chtml | tex, mml | chtml | yes +| tex-mml-svg | tex, mml | svg | +| mml-chtml | mml | chtml | +| mml-svg | mml | svg | + +Use the `source` key to set used MathJax distribution. +By default the `https://cdn.jsdelivr.net/npm/mathjax@3/es5` value is used. +If value starts with `/` symbol it will be interpreted relative +to [source/build](configuration/general.md) directory. + +For example to use local MathJax copy for tex input and svg output you can +do something like: + +```console +$ wget https://github.com/mathjax/MathJax/archive/refs/tags/3.2.2.tar.gz +$ tar -xf 3.2.2.tar.gz MathJax-3.2.2/es5 +$ mv MathJax-3.2.2 src/mathjax@3 +``` + +Then add to your `book.toml` file: + +```toml +[output.html.mathjax] +enable = true +source = "/mathjax@3/es5" +config = "tex-svg" +``` + +[comb-comp]: https://docs.mathjax.org/en/v3.2-latest/web/components/combined.html