Mado: Fast Markdown linter written in Rust

A new Markdown linter named Mado, written in Rust, has been released, claiming to be up to 60 times faster than existing linters such as markdownlint. The tool supports CommonMark and GitHub Flavored Markdown (GFM) and is available for installation across multiple platforms. Developers and teams working with Markdown files may benefit from its performance improvements.

Mado is a fast, open-source Markdown linter developed in Rust, designed to check Markdown files against most markdownlint rules. It claims to achieve performance approximately 49-60 times faster than tools like markdownlint-cli and markdownlint, based on benchmark tests conducted on a MacBook Pro (2021, M1 Max) using a dataset of around 1,500 Markdown files. The tool is compatible with CommonMark and GFM, supporting a broad set of markdownlint rules, with some marked as unstable or unsupported.

Installation options include Homebrew, Nix, Pacman, Scoop, and WinGet, with pre-built binaries available on the project’s GitHub release page. Mado can be configured via local or global configuration files, and it is compatible with GitHub Actions for integration into CI pipelines. The project is actively maintained, with ongoing development and benchmarking efforts documented in its repository.

Why It Matters

The release of Mado represents a notable advancement for developers who rely on Markdown linting, especially in large projects where performance bottlenecks can slow workflows. Its speed advantage could reduce linting time significantly, improving developer productivity. Additionally, its Rust implementation suggests potential for better stability and performance compared to traditional tools written in scripting languages like Ruby or Node.js.

Background

Existing Markdown linters such as markdownlint (Ruby) and markdownlint-cli (Node.js) are widely used but have performance limitations, especially with large codebases. Mado’s development responds to this need for faster, more efficient tools. The project has already demonstrated benchmarking results showing substantial speed improvements, and it is positioned as a drop-in replacement for existing linting workflows.

“Mado offers a significant performance boost for Markdown linting, making it more suitable for large-scale projects.”

— Akiomik, developer of Mado

“The speed improvements could be a game-changer for teams managing extensive Markdown documentation.”

— Hacker News community member

What Remains Unclear

It is not yet clear how Mado performs across all markdownlint rules, especially the unsupported or unstable ones. Long-term stability, compatibility with various CI/CD pipelines, and user adoption rates are still developing. Further testing and user feedback are needed to confirm its effectiveness in diverse environments.

What’s Next

Next steps include broader adoption by the developer community, further testing in real-world projects, and potential integration into popular CI/CD workflows. Ongoing development may also introduce new features or expand rule support.

Key Questions

How does Mado compare in performance to existing Markdown linters?

Benchmark tests indicate Mado is approximately 49-60 times faster than tools like markdownlint-cli and markdownlint, especially on large datasets.

What platforms are supported for installing Mado?

Mado is available via Homebrew (macOS/Linux), Nix, Pacman (Linux), Scoop (Windows), WinGet (Windows), and pre-built binaries from GitHub.

Does Mado support all markdownlint rules?

Mado supports most markdownlint rules, with some marked as unstable or unsupported. Compatibility with all rules is still being evaluated.

Can Mado be integrated into CI/CD pipelines?

Yes, Mado is compatible with GitHub Actions and other automation tools, facilitating integration into automated workflows.

Is Mado open source and actively maintained?

Yes, Mado is open source, hosted on GitHub, with ongoing development and benchmarking efforts documented in its repository.