Dinja

Safe, deterministic MDX rendering powered by a Rust core with batteries-included Python bindings.

Why dinja?

• Native performance – the renderer is written in Rust and avoids Node.js runtime costs.
• Identical output everywhere – both the Rust crate and the Python bindings call into the same engine.
• Zero setup – static JS dependencies are embedded and extracted on demand.
• Prebuilt binaries – PyPI ships wheels for Linux, macOS (x86/arm), and Windows (abi3-py313+).

Installation

Usage

Rust

use dinja_core::service::{RenderService, RenderServiceConfig};

fn main() -> anyhow::Result<()> {
    let config = RenderServiceConfig::default();
    let service = RenderService::new(config)?;

    let html = service.render_string("example.mdx", "# Hello **dinja**")?;
    println!("{html}");
    Ok(())
}

Python

from dinja import render

payload = {
    "settings": {"output": "html", "minify": True, "engine": "base"},
    "mdx": {"example.mdx": "---\ntitle: Demo\n---\n# Hello **dinja**"},
}

result = render(payload)
entry = result["files"]["example.mdx"]

if entry["status"] == "success":
    rendered = entry["result"]
    metadata = rendered.get("metadata", {})
    print("title:", metadata.get("title"))
    print("html:", rendered.get("output"))
else:
    print("error:", entry.get("error"))

rendered["output"] contains HTML, JavaScript, or schema code depending on settings["output"].

More examples live in python-bindings/examples/.

Development

License

BSD 3-Clause. See LICENSE.