# Install markdownlint-cli with Homebrew, chocolatey, Nix, pacman, apt, scoop

CLI for Node.js style checker and lint tool for Markdown files. Version 0.49.0 via Homebrew; verified 2026-06-18.

## Install

```sh
sudo av install brew:markdownlint-cli
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install markdownlint-cli
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#markdownlint-cli
```

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

- pacman (92%):

```sh
sudo pacman -S markdownlint-cli
```

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

- Debian apt (92%):

```sh
sudo apt install markdownlint
```

  Evidence: Debian stable package indexes: markdownlint from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

### Windows

- Chocolatey (92%):

```sh
choco install markdownlint-cli
```

  Evidence: Chocolatey community package catalog: markdownlint-cli from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='10.8512','kmupd4'

- Scoop (92%):

```sh
scoop install extras/.markdownlint
```

  Evidence: Scoop official bucket manifest trees: .markdownlint.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:markdownlint-cli
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/markdownlint-cli>
- **Version:** 0.49.0
- **Source summary:** CLI for Node.js style checker and lint tool for Markdown files
- **Homepage:** <https://github.com/igorshubovych/markdownlint-cli>
- **Repository:** <https://github.com/igorshubovych/markdownlint-cli>
- **Upstream docs:** <https://github.com/igorshubovych/markdownlint-cli#readme>
- **License:** MIT
- **Source archive:** <https://registry.npmjs.org/markdownlint-cli/-/markdownlint-cli-0.49.0.tgz>
- **Last updated:** 2026-06-18T08:09:52Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- markdownlint (cli)
- markdownlint (alias)

## Dependencies

- node

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.49.0
- Package-manager updated: 2026-06-18
- Local data: ok
- Upstream repository: https://github.com/igorshubovych/markdownlint-cli
- info: No cached GitHub release or tag data was available.
## Project history and usage

markdownlint-cli is the command-line interface for David Anson's markdownlint rules, packaged as a Node.js CLI named markdownlint.

### Project history

The official repository was created in 2016 and positions the project as a CLI wrapper around the markdownlint package. Its README documents npm installation, Homebrew installation on macOS, Docker/GitHub Packages usage, glob handling, automatic fixes, configuration files, exit codes, and pre-commit integration.

The CLI evolved as practical automation around Markdown style rules: it can lint files, directories, and globs; read from stdin; emit JSON; ignore files; apply basic fixes; load custom rules; and override rule enable/disable settings from the command line.

### Adoption history

markdownlint-cli became part of Markdown quality gates for repositories because it fits npm scripts, shell commands, Docker, and pre-commit hooks. The supplied package facts show packaging across Homebrew, Chocolatey, Debian/Ubuntu, Nix, Arch, and Scoop, which is broad coverage for a documentation linter.

### How it is used

Users typically run markdownlint against Markdown file globs, often quoting globs so the CLI rather than the shell expands them. Configuration can be supplied with --config or discovered from .markdownlint.jsonc, .markdownlint.json, .markdownlint.yaml, .markdownlint.yml, or .markdownlintrc; .markdownlintignore is used for exclusions unless --ignore-path points elsewhere.

The tool is common in CI because it has documented exit codes and can be added to pre-commit with the official repository as the hook source.

### Why package nerds care

markdownlint-cli is package-manager-relevant because it turns a JavaScript linting library into a predictable cross-platform command. It is one of the standard small tools maintainers reach for when Markdown style needs to be enforced alongside code linting.

### Timeline

- 2016: GitHub repository created.
- 2016 onward: Tags begin with early 0.x releases and continue through later v0.x versions.
- 2026: Supplied package facts show packaging across npm-oriented and OS package-manager ecosystems.

### Related projects

- The README identifies markdownlint as the underlying API/rules package.
- The README lists markdownlint-cli2 as an alternate CLI implementation.

### Sources

- <https://api.github.com/repos/igorshubovych/markdownlint-cli>
- <https://github.com/DavidAnson/markdownlint>
- <https://github.com/igorshubovych/markdownlint-cli>
- source_facts.package-manager


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## 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

- Unix: .markdownlint.jsonc, .markdownlint.json, .markdownlint.yaml, .markdownlint.yml, .markdownlintrc, .markdownlintignore, file supplied with --config
## Source Database Details

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

## Other Package-Manager Records

- Nix - markdownlint-cli: normalized package name match | nixpkgs package indexes: pkgs/by-name/ma/markdownlint-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- pacman - markdownlint-cli - 0.48.0-1: normalized package name match | Arch Linux sync databases: markdownlint-cli from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Command-line interface for MarkdownLint | https://github.com/igorshubovych/markdownlint-cli
- Chocolatey - markdownlint-cli: normalized package name match | Chocolatey community package catalog: markdownlint-cli from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='10.8512','kmupd4'
- Debian apt - markdownlint - 0.13.0-4: installed executable or alias match | Debian stable package indexes: markdownlint from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Markdown lint tool | https://github.com/markdownlint/markdownlint
- Ubuntu apt - markdownlint - 0.13.0-4: installed executable or alias match | Ubuntu 24.04 LTS package indexes: markdownlint from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Markdown lint tool | https://github.com/markdownlint/markdownlint
- pacman - markdownlint - 0.17.0-1: installed executable or alias match | Arch Linux sync databases: markdownlint from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A lint tool to check markdown files and flag style issues | https://github.com/markdownlint/markdownlint
- Scoop - extras/.markdownlint: installed executable or alias match | Scoop official bucket manifest trees: .markdownlint.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1
- Scoop - main/.markdownlint: installed executable or alias match | Scoop official bucket manifest trees: .markdownlint.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1
- Scoop - versions/.markdownlint: installed executable or alias match | Scoop official bucket manifest trees: .markdownlint.json from https://api.github.com/repos/ScoopInstaller/Versions/git/trees/master?recursive=1


## 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.
- [node](https://www.automicvault.com/pkg/brew/node/) - Runtime dependency declared by Homebrew.
- [markdownlint-cli2](https://www.automicvault.com/pkg/brew/markdownlint-cli2/) - Package name indicates the same formula family.
- [bashate](https://www.automicvault.com/pkg/brew/bashate/) - Shares av.db curated category or tags: cli, developer-tools, linting, style-checker.
- [comrak](https://www.automicvault.com/pkg/brew/comrak/) - Shares av.db curated category or tags: cli, commonmark, developer-tools, markdown.
- [cpplint](https://www.automicvault.com/pkg/brew/cpplint/) - Shares av.db curated category or tags: cli, developer-tools, linting, style-checker.
- [editorconfig-checker](https://www.automicvault.com/pkg/brew/editorconfig-checker/) - Shares av.db curated category or tags: cli, developer-tools, linting, style-checker.
- [actionlint](https://www.automicvault.com/pkg/brew/actionlint/) - Shares av.db curated category or tags: cli, developer-tools, linting.
- [bpmnlint](https://www.automicvault.com/pkg/brew/bpmnlint/) - Shares av.db curated category or tags: cli, developer-tools, linting.
- [checkbashisms](https://www.automicvault.com/pkg/brew/checkbashisms/) - Shares av.db curated category or tags: cli, developer-tools, linting.
- [markdownlint-cli](https://www.automicvault.com/pkg/npm/markdownlint-cli/) - Same normalized package name appears in another local ecosystem. Shared terms: markdown, markdownlint, markdownlint-cli.
- [cmake-lint](https://www.automicvault.com/pkg/brew/cmake-lint/) - Local package facts share a topical domain. Shared terms: checker, cli, developer, developer-tools, files.
- [markdownlint-cli](https://www.automicvault.com/pkg/npm/markdownlint-cli/) - Same normalized package name in another local ecosystem.

## Combined YAML source

View the package source record on GitHub. [combined/markdownlint-cli.yml](https://github.com/automic-vault/db/blob/main/combined/markdownlint-cli.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
