Mado: Fast Markdown linter written in Rust

· coding systems devtools · Source ↗

TLDR

  • Rust-based Markdown linter compatible with CommonMark and GFM, benchmarked at 49-60x faster than markdownlint on ~1,500 files.

Key Takeaways

  • Benchmark on M1 Max: mado runs in 0.129s vs 6.4-7.8s for markdownlint-cli (Node), markdownlint (Ruby), and markdownlint-cli2 (Node).
  • Supports most markdownlint rules (MD001-MD047); a handful marked unstable, a few with unsupported options.
  • Config via mado.toml, global config paths per OS, JSON Schema available, and native GitHub Actions integration.
  • Install via Homebrew, Nix, Arch pacman, Scoop, or WinGet; pre-built binaries also on release page.
  • Development tooling includes hyperfine benchmarking, flamegraph profiling, and cargo-fuzz for fuzz testing.

Hacker News Comment Review

  • The main discussion compares mado to rumdl, another Rust markdown linter; mado is older (April 2024 vs March 2025) and faster per rumdl’s own benchmarks.
  • Key differentiator: mado is linter-only; rumdl adds partial formatting and an LSP, making them partially complementary rather than direct replacements.

Notable Comments


Original | Discuss on HN