# markdownlint-cli2 Markdown Linting for Docs and Repos

> This skill uses markdownlint-cli2 to enforce consistent Markdown quality across docs, READMEs, and content repositories. It is built for local authoring, pull-request checks, and CI enforcement with rule-based output.

- Skill: `agentskillexchange/markdownlint-cli2-markdown-linting-for-docs-and-repos` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agentskillexchange/markdownlint-cli2-markdown-linting-for-docs-and-repos`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentskillexchange/markdownlint-cli2-markdown-linting-for-docs-and-repos/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: agentskillexchange (https://skillmd.com/u/agentskillexchange)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/agentskillexchange/markdownlint-cli2-markdown-linting-for-docs-and-repos

---


# markdownlint-cli2 Markdown Linting for Docs and Repos

This skill uses markdownlint-cli2 to enforce consistent Markdown quality across docs, READMEs, and content repositories. It is built for local authoring, pull-request checks, and CI enforcement with rule-based output.

## Installation

Use the upstream install or setup path that matches your environment:
- npm install markdownlint-cli2 --global
- npm install markdownlint-cli2 --save-dev
- docker pull davidanson/markdownlint-cli2
- brew install markdownlint-cli2

Requirements and caveats from upstream:
- As a development dependency of the current [Node.js][nodejs] package:
- As a [Docker][docker] container image:
- [CommonMark][commonmark] files on [Node.js][nodejs] using the

Basic usage or getting-started notes:
- As a global CLI:
- bash
- As a global CLI with [Homebrew][homebrew]:

- Source: https://github.com/DavidAnson/markdownlint-cli2
- Extracted from upstream docs: https://raw.githubusercontent.com/DavidAnson/markdownlint-cli2/HEAD/README.md

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/markdownlint-cli2-markdown-linting-docs-repos/)