# Install mado with Homebrew, apk, Nix, pacman

Fast Markdown linter written in Rust. Version 0.3.0 via Homebrew; verified 2026-05-14.

## Install

```sh
sudo av install brew:mado
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install mado
```

  Evidence: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add mado
```

  Evidence: Alpine Linux edge package indexes: mado from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Nix (92%):

```sh
nix profile install nixpkgs#mado
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ma/mado/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S mado
```

  Evidence: Arch Linux sync databases: mado from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

## Package facts

- **Package key:** brew:mado
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/mado>
- **Version:** 0.3.0
- **Source summary:** Fast Markdown linter written in Rust
- **Homepage:** <https://github.com/akiomik/mado>
- **Repository:** <https://github.com/akiomik/mado>
- **Upstream docs:** <https://github.com/akiomik/mado#readme>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/akiomik/mado/archive/refs/tags/v0.3.0.tar.gz>
- **Last updated:** 2026-05-14T20:18:44Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- mado (cli)
- mado (alias)

## Build dependencies

- rust

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.3.0
- Package-manager updated: 2026-05-14
- Local data: ok
- Upstream repository: https://github.com/akiomik/mado
- Upstream latest detected: v0.3.0 (current)
## Project history and usage

Mado is a fast Markdown linter written in Rust. The official README states that it is compatible with CommonMark and GitHub Flavored Markdown and supports most markdownlint rules.

### Project history

The project is developed in the akiomik/mado GitHub repository, with Rust source, tests, fuzzing, benchmarks, a GitHub Action, and package definitions. Its release tags run from v0.1.0 through v0.3.0, and the repository page lists v0.3.0 as the latest release on Apr 11, 2025.

### Adoption history

Mado’s official README documents installation through Homebrew, Nix, Arch Linux, Scoop, WinGet, and prebuilt release binaries. It also provides GitHub Actions usage, which makes the linter relevant both as a local CLI and a CI check.

### How it is used

The basic workflow is `mado check .` or `mado check path/to/*.md`. Configuration can be placed in `mado.toml` or `.mado.toml` in the current directory, with global configuration under `~/.config/mado/mado.toml` on Linux and macOS and under the Roaming AppData path on Windows.

### Why package nerds care

Mado is package-nerd relevant because it is a Rust-native alternative in a space long occupied by Ruby and Node markdownlint tools. The official benchmark claims a large speed advantage on a documentation-sized corpus, which is exactly the sort of difference that matters in monorepos and pre-commit or CI lint loops.

### Timeline

- Public repository: Official Git tags begin at v0.1.0.
- 2025: GitHub repository page lists v0.3.0 as the latest release on Apr 11, 2025.
- 2025: README documents package-manager installs and GitHub Actions usage for v0.3.0.

### Related projects

- Mado is related to markdownlint, markdownlint-cli, markdownlint-cli2, CommonMark, and GitHub Flavored Markdown. Its README positions it as mostly markdownlint-rule-compatible while emphasizing Rust performance.

### Sources

- <https://github.com/akiomik/mado>
- <https://github.com/akiomik/mado#readme>
- <https://raw.githubusercontent.com/akiomik/mado/main/README.md>


## Security Notes

No matching local secret-handling manifest was found for mado. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Linux: mado.toml, .mado.toml, ~/.config/mado/mado.toml
- macOS: mado.toml, .mado.toml, ~/.config/mado/mado.toml
- Windows: mado.toml, .mado.toml, ~\AppData\Roaming\mado\mado.toml
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** mado
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Nix - mado: normalized package name match | nixpkgs package indexes: pkgs/by-name/ma/mado/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - mado - 0.3.0-r0: normalized package name match | Alpine Linux edge package indexes: mado from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | A fast Markdown linter written in Rust | https://github.com/akiomik/mado
- apk - mado-bash-completion - 0.3.0-r0: normalized package name match | Alpine Linux edge package indexes: mado-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Bash completions for mado | https://github.com/akiomik/mado
- apk - mado-doc - 0.3.0-r0: normalized package name match | Alpine Linux edge package indexes: mado-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | A fast Markdown linter written in Rust (documentation) | https://github.com/akiomik/mado
- apk - mado-fish-completion - 0.3.0-r0: normalized package name match | Alpine Linux edge package indexes: mado-fish-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Fish completions for mado | https://github.com/akiomik/mado
- apk - mado-zsh-completion - 0.3.0-r0: normalized package name match | Alpine Linux edge package indexes: mado-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Zsh completions for mado | https://github.com/akiomik/mado
- pacman - mado - 0.3.0-1: normalized package name match | Arch Linux sync databases: mado from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A fast Markdown linter written in Rust | https://github.com/akiomik/mado


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [oxlint](https://www.automicvault.com/pkg/brew/oxlint/) - Shares av.db curated category or tags: cli, developer-tools, linter, linting, rust.
- [sherif](https://www.automicvault.com/pkg/brew/sherif/) - Shares av.db curated category or tags: cli, developer-tools, linter, linting, rust.
- [doc8](https://www.automicvault.com/pkg/brew/doc8/) - Shares av.db curated category or tags: cli, developer-tools, linter, linting.
- [elvis](https://www.automicvault.com/pkg/brew/elvis/) - Shares av.db curated category or tags: cli, developer-tools, linter, linting.
- [falco](https://www.automicvault.com/pkg/brew/falco/) - Shares av.db curated category or tags: cli, developer-tools, linter, linting.
- [gitlint](https://www.automicvault.com/pkg/brew/gitlint/) - Shares av.db curated category or tags: cli, developer-tools, linter, linting.
- [htmlhint](https://www.automicvault.com/pkg/brew/htmlhint/) - Shares av.db curated category or tags: cli, developer-tools, linter, linting.
- [iblinter](https://www.automicvault.com/pkg/brew/iblinter/) - Shares av.db curated category or tags: cli, developer-tools, linter, linting.
- [rumdl](https://www.automicvault.com/pkg/brew/rumdl/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, linter, markdown.
- [markdownlint-cli2](https://www.automicvault.com/pkg/brew/markdownlint-cli2/) - Both packages work with overlapping file formats or content types. Shared terms: cli, developer, developer-tools, fast, linting.

## Combined YAML source

View the package source record on GitHub. [combined/mado.yml](https://github.com/automic-vault/db/blob/main/combined/mado.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
