28 releases

0.7.5 Jun 27, 2022
0.7.3 Aug 15, 2020
0.7.2 Feb 7, 2020
0.6.3 Apr 28, 2019
0.1.2 Jul 28, 2015

#135 in WebSocket

Download history 67/week @ 2024-02-19 17/week @ 2024-02-26 12/week @ 2024-03-04 26/week @ 2024-03-11 21/week @ 2024-03-18

76 downloads per month
Used in 2 crates

MIT/Apache

3MB
34K SLoC

JavaScript 34K SLoC // 0.1% comments Rust 557 SLoC // 0.0% comments

aurelius

aurelius is a complete solution for live-previewing markdown as HTML.

This crate provides a server that can render and update an HTML preview of markdown without a client-side refresh. Upon receiving an HTTP request, the server responds with an HTML page containing a rendering of supplied markdown. Client-side JavaScript then initiates a WebSocket connection which allows the server to push changes to the client.

Full documentation may be found here.

This crate was designed to power vim-markdown-composer, a markdown preview plugin for Neovim, but it may be used to implement similar plugins for any editor. See vim-markdown-composer for a real-world usage example.

Acknowledgments

This crate is inspired by suan's instant-markdown-d.

Why the name?

"Aurelius" is a Roman gens (family name) shared by many famous Romans, including emperor Marcus Aurelius, one of the "Five Good Emperors." The gens itself originates from the Latin aureus meaning "golden." Also, tell me that "Markdown Aurelius" isn't a great pun.

Aurelia (gens) on Wikipedia.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~10MB
~220K SLoC