---
id: mrml
version: "0.2.4"
license: unclear
license_treatment: unclear
maintenance: active
---

# mrml — A Python wrapper for MRML (Rust port of MJML).

License: unclear · Maintenance: active · Downloads: 1.0M/mo

## What it is and what it does

mrml is a Python wrapper around a Rust reimplementation of MJML, a markup language designed for building responsive email templates. It translates MJML syntax into production-ready HTML, handling the complexity of email client compatibility so developers don't have to. The package has no runtime dependencies and exposes a simple API: pass MJML markup to `to_html()` and receive HTML output. It supports advanced features like file includes via a pluggable loader system, allowing you to compose templates from separate files or in-memory sources.

The package is built on compiled Rust bindings, which means installation requires platform-specific wheels rather than pure Python code. Wheels are provided for common architectures (x86_64, ARM, PowerPC, s390x on Linux; x86_64 and ARM on macOS; x86_64 on Windows) and Python versions 3.10–3.12, with declared support back to Python 3.7. The project is actively maintained, with recent commits and no known security vulnerabilities.

Use it for:

- Generate responsive email HTML from MJML markup without manually handling email client quirks.
- Build email template systems that compose reusable MJML components via includes.
- Convert MJML designs to production HTML in CI/CD pipelines or backend services.
- Prototype responsive emails quickly using MJML's higher-level syntax instead of raw HTML.
- Integrate email template rendering into Python web frameworks or batch email services.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Converts MJML (a markup language for responsive emails) to HTML using a Rust-based implementation, with support for includes and custom parsing options.

Yes, if you need to convert MJML to HTML and can tolerate medium install friction from compiled bindings. The package is actively maintained, has no security issues, and offers a clean API with no runtime dependencies. The main caveat is the unclear license status—verify licensing terms before adopting in proprietary projects. Installation should be straightforward on common platforms thanks to pre-built wheels.

## Install

pip install mrml
uv add mrml
poetry add mrml

## Installing mrml

Before you install: Medium install friction due to compiled Rust bindings, but wheels are available for common platforms (x86_64, ARM, Windows, macOS). Package is actively maintained with recent releases and no known vulnerabilities.

License in practice: License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license before using in proprietary or restricted contexts.

Quickstart:

import mrml

result = mrml.to_html("<mj-body><mj-text>Hello</mj-text></mj-body>")
print(result.content)

Requires Python 3.7 or later; compiled wheels available for most platforms but may require compilation on unsupported architectures.

Verify before relying:

- Whether the package includes documentation or examples beyond the GitHub repository.
- Exact license terms and compatibility with common open-source and proprietary workflows.
- Performance characteristics and limits for large or complex MJML templates.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 1.0M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

mjml to html conversion, email template markup language, responsive email generation, mjml parser python, email html builder, mjml rust wrapper, responsive email templates, email-templates, markup-language, rust-binding

[View on SkillFed](https://skillfed.io/packages/mrml) · [View on PyPI](https://pypi.org/project/mrml/)