# katex-rs
[](https://github.com/xu-cheng/katex-rs/actions)
[](https://crates.io/crates/katex)
[](https://docs.rs/katex)
This crate offers Rust bindings to [KaTeX](https://katex.org). This allows you to render LaTeX equations to HTML.
## Documentation
<https://docs.rs/katex>
## Usage
Add this to your `Cargo.toml`:
```toml
[dependencies]
katex = "0.4"
```
This crate offers the following features:
* `quick-js`: Enable by default. Use [quick-js](https://crates.io/crates/quick-js) as the JS backend.
* `duktape`: Use [duktape](https://crates.io/crates/ducc) as the JS backend. You need to disable the default features to enable this backend.
* `wasm-js`: Use [wasm-bindgen](https://crates.io/crates/wasm-bindgen) and [js-sys](https://crates.io/crates/js-sys) as the JS backend. You need to disable the default features to enable this backend.
## Examples
```rust
let html = katex::render("E = mc^2").unwrap();
let opts = katex::Opts::builder().display_mode(true).build().unwrap();
let html_in_display_mode = katex::render_with_opts("E = mc^2", &opts).unwrap();
```
## See Also
* [pandoc-katex](https://github.com/xu-cheng/pandoc-katex)
## License
<sup>
Licensed under either of <a href="LICENSE-APACHE">Apache License, Version 2.0</a> or <a href="LICENSE-MIT">MIT license</a> at your option.
</sup>
<br>
<sub>
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
</sub>