A fast Markdown linter written in Rust. Compatible with CommonMark and GitHub Flavored Markdown (GFM).
mado check .
mado check path/to/*.mdApprox. 49-60x faster than existing linters (e.g. markdownlint).
---
config:
xyChart:
height: 200
titleFontSize: 14
chartOrientation: horizontal
xAxis:
labelFontSize: 12
titleFontSize: 14
yAxis:
labelFontSize: 12
titleFontSize: 14
---
xychart-beta
title "Linting ~1,500 Markdown files (Lower is faster)"
x-axis ["mado (rust)", "markdownlint-cli (node.js)", "markdownlint (ruby)", "markdownlint-cli2 (node.js)"]
y-axis "Time (seconds)" 0 --> 10
bar [0.129, 6.381, 6.609, 7.817]
This benchmark was conducted on a MacBook Pro (2021, M1 Max) using hyperfine with GitLab documentation as the dataset.
brew tap akiomik/mado https://github.com/akiomik/mado.git
brew install madonix profile install github:akiomik/madopacman -S madoscoop install https://raw.githubusercontent.com/akiomik/mado/refs/heads/main/pkg/scoop/mado.json# For security reasons, installing from local manifest files requires that this feature be enabled by an administrator.
# For more details, see https://learn.microsoft.com/en-us/windows/package-manager/winget/install#local-install
winget settings --enable LocalManifestFiles
curl.exe -o mado.yml https://raw.githubusercontent.com/akiomik/mado/refs/heads/main/pkg/winget/mado.yml
winget install -m mado.ymlPre-built binaries are available for download from the release page.
Mado supports most markdownlint rules.
- ✅ Stable support
- 🔨 Unstable support
⚠️ Unsupported option(s)- ❌ Not supported
| Rule | Support | Note |
|---|---|---|
| MD001 | ✅ | |
| MD002 | ✅ | |
| MD003 | 🔨 | |
| MD004 | ✅ | |
| MD005 | ✅ | |
| MD006 | ✅ | |
| MD007 | 🔨 | |
| MD009 | ✅ | |
| MD010 | ✅ | |
| MD012 | ✅ | |
| MD013 | ✅ | |
| MD014 | ✅ | |
| MD018 | ✅ | |
| MD019 | ✅ | |
| MD020 | 🔨 | |
| MD021 | ✅ | |
| MD022 | ✅ | |
| MD023 | ✅ | |
| MD024 | ✅ | |
| MD025 | ✅ | |
| MD026 | ✅ | |
| MD027 | 🔨 | |
| MD028 | ✅ | |
| MD029 | ✅ | |
| MD030 | ✅ | |
| MD031 | ✅ | |
| MD032 | 🔨 | |
| MD033 | ✅ | |
| MD034 | ✅ | |
| MD035 | ✅ | |
| MD036 | ✅ | |
| MD037 | ✅ | |
| MD038 | ✅ | |
| MD039 | ✅ | |
| MD040 | ✅ | |
| MD041 | ✅ | |
| MD046 | ✅ | |
| MD047 | ✅ |
Mado can be configured via mado.toml or .mado.toml file in the current directory.
You can also use global configuration files located in:
Linux:~/.config/mado/mado.tomlmacOS:~/.config/mado/mado.tomlWindows:~\AppData\Roaming\mado\mado.toml
For more details,
see the example mado.toml
and the JSON Schema for mado.toml.
Mado is compatible with GitHub Actions.
# Basic usage (runs `mado check .`)
- uses: akiomik/[email protected]
# Custom usage (runs `mado` with specified arguments)
- uses: akiomik/[email protected]
with:
args: '--config path/to/mado.toml check path/to/*.md'just is required.
just testjust lint# Download Markdown dataset
./scripts/benchmarks/setup.sh
# Benchmark mado, mdl and markdownlint-cli using hyperfine
./scripts/benchmarks/comparison.shFirst, install flamegraph:
cargo install flamegraphThen run:
just flamegraphFirst, install cargo-fuzz:
cargo install cargo-fuzzThen run:
just fuzz