# Markdownlint CLI

> Use this skill when the user wants to lint Markdown files for style consistency, heading structure, list formatting, and documentation quality.

- Skill: `javimosch/markdownlint-cli` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/markdownlint-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/markdownlint-cli/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/markdownlint-cli

---


# markdownlint-cli Plugin

markdownlint-cli checks Markdown files against configurable style rules.

## Usage Examples

- "lint README.md for common issues"
- "check all markdown files in docs/"
- "auto-fix markdown style violations"
- "lint with custom markdownlint config"

## Installation

```bash
npm install -g markdownlint-cli
```

## Key Features
- 100+ configurable Markdown style rules
- Heading structure validation
- List and code block formatting
- Line length checking
- Automatic fix mode
- Custom rule configuration (.markdownlint.json)
- JSON output for CI pipeline
- Ignore pattern support