2017-11-01 11:58:24 +01:00
# <img align="right" src="maud.png" alt="HTML5 rocks." title="HTML5 rocks."> maud
2019-09-14 13:48:59 +12:00
[](http://travis-ci.org/lambda-fairy/maud)
2017-11-01 11:58:24 +01:00
[](https://crates.io/crates/maud)
[](https://docs.rs/maud/)
2014-12-17 21:11:56 +13:00
2017-03-17 20:55:23 +13:00
[Documentation][book] ([source][booksrc]) • [API reference][apiref] • [Change log][changelog]
2014-12-17 21:11:56 +13:00
2016-09-25 12:50:33 +13:00
Maud is an HTML template engine for Rust. It's implemented as a macro, `html!` , which compiles your markup to specialized Rust code. This unique approach makes Maud templates blazing fast, super type-safe, and easy to deploy.
2015-03-14 21:28:04 +13:00
2017-07-30 16:25:44 +12:00
Note that Maud depends on the unstable [procedural macro API][rustissue], and so requires the nightly version of Rust.
2015-03-14 21:28:04 +13:00
2016-09-25 12:50:33 +13:00
For more info on Maud, see the [official book][book].
2015-05-28 19:15:56 +12:00
2016-09-25 12:50:33 +13:00
[book]: https://maud.lambda.xyz/
2019-09-14 13:48:59 +12:00
[booksrc]: https://github.com/lambda-fairy/maud/tree/master/docs
2017-07-30 16:25:44 +12:00
[apiref]: https://docs.rs/maud/
2019-09-14 13:48:59 +12:00
[changelog]: https://github.com/lambda-fairy/maud/blob/master/CHANGELOG.md
2017-07-30 16:25:44 +12:00
[rustissue]: https://github.com/rust-lang/rust/issues/38356
2015-05-28 19:15:56 +12:00
2016-09-25 12:50:33 +13:00
## Stability
2016-11-17 20:37:17 +13:00
As of version 0.11, I am satisfied with the core syntax and semantics of the library. Development at this stage is focused on adding features and fixing bugs.
2016-09-25 12:50:33 +13:00
2017-07-30 16:25:44 +12:00
The underlying procedural macro API is still unstable though, so updating your compiler may break things. Please file an issue when this happens!