# Markdown Lint

> Guide for linting markdown files using markdownlint-cli2. Use this when asked to lint markdown, fix markdown formatting, or check markdown files. Use when this capability is needed.

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

---


# Markdown Linting with markdownlint-cli2

## Commands

```bash
# Lint markdown files
npm run markdown-lint

# Auto-fix markdown issues
npm run markdown-lint:fix
```

## Configuration

Configuration is in `.markdownlint-cli2.yaml`. See that file for enabled rules and ignored paths.

[Rule reference](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md)

## Workflow

1. Run `npm run markdown-lint` to identify issues
2. Run `npm run markdown-lint:fix` to auto-fix most issues
3. Manually fix remaining issues if needed
4. Verify with `npm run markdown-lint`

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/heaths) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->