mdn/rari

Rari is a Rust-based build system that transforms markdown content into structured JSON output for documentation sites.

The tool solves the problem of efficiently processing large volumes of markdown documentation and translations into a format suitable for web delivery. It works by parsing markdown files and converting them into JSON structures that can be consumed by frontend applications. Rari was built as a performance-focused rewrite of an existing build system, prioritizing speed and reliability for handling MDN's substantial content library.

Rari is designed for teams maintaining large documentation sites, particularly those with multilingual content and frequent updates. It suits projects where build performance matters and where content needs to be transformed into structured, machine-readable formats. The tool is currently undergoing active development toward feature parity with its predecessor, meaning its API and behavior may change significantly during this stabilization phase. Teams considering adoption should be aware that the project is not yet accepting external contributions and that the codebase remains unstable until the rewrite is complete.

The project is in active development with ongoing work toward achieving feature parity with the system it replaces. The maintainers are focused on completing core functionality before opening the codebase to broader contributions. Documentation and supporting resources are still being developed, with communication happening through the project's Discord channel.