#cli #email #mjml

app mrml-cli

CLI for the Rust implementation of MJML renderer

10 releases (6 stable)

new 1.3.1 May 15, 2021
1.3.0 May 13, 2021
1.2.0 Apr 21, 2021
0.4.0 Jan 31, 2021
0.3.3 Oct 14, 2020

#25 in Email

Download history 14/week @ 2021-01-28 3/week @ 2021-02-04 64/week @ 2021-02-11 8/week @ 2021-02-18 2/week @ 2021-02-25 4/week @ 2021-03-04 1/week @ 2021-03-11 16/week @ 2021-03-25 18/week @ 2021-04-01 7/week @ 2021-04-08 43/week @ 2021-04-15 12/week @ 2021-04-22 9/week @ 2021-04-29 1/week @ 2021-05-06

74 downloads per month

Custom license

225 lines


Crates.io Crates.io

Build Status codecov



This project is a reimplementation of the nice MJML markup language in Rust.

How to use it in the cli

# installing mrml-cli
cargo install mrml-cli
# using it 
mrml-cli path/to/template.mjml validate
mrml-cli path/to/template.mjml render
mrml-cli path/to/template.mjml format-json --pretty
mrml-cli path/to/template.json format-mjml --pretty
# getting some help
mrml-cli --help

How to use it in my code

use mrml;

fn main() {
    let root = mrml::parse("<mjml><mj-body></mj-body></mjml>").expect("parse template");
    let opts = mrml::prelude::render::Options::default();
    match root.render(&opts) {
        Ok(content) => println!("{}", content),
        Err(_) => println!("couldn't render mjml template"),


  • A Node server rendering a mjml template takes around 20Mo of RAM at startup and 130Mo under stress test. In Rust, less than 1.7Mo at startup and a bit less that 3Mo under stress test. The Rust version can also handle 2 times more requests per seconds. You can run the bench by doing bash script/run-bench.sh.
  • The JS implementation cannot be run in the browser. In Rust (and Wasm), you can.

You want to contribute?

Feel free to read our contributing section and the code of conduct.


With the same linux amd64 machine, to render the amario template

  • Node: 62.803ms
  • Rust: 13.180ms

To reproduce those results:

  • Node, in example/mjml-bench run npm start -- ../../resources/template-amario.mjml
  • Rust, run cargo bench amario

Who is using MRML?

If you are using MRML and want to be added to this list, don't hesitate to create an issue or open a pull request.


~117K SLoC