doc-validate-markdown
Validate markdown files for formatting, links, and style compliance using markdownlint. Use before committing documentation changes.
- Category: discovered
- Tags: github, community
- Version: 1.0.0
- Author: walid
- Downloads: 0
- GitHub stars: 4
- Updated: 2025-11-21
Download the latest version (v1.0.0) from this page.
SKILL.md
--- name: doc-validate-markdown description: Validate markdown files for formatting, links, and style compliance using markdownlint. Use before committing documentation changes. --- # Validate Markdown Skill Validate markdown files for formatting and style. ## When to Use - Before committing documentation - Markdown linting errors in CI - Creating new documentation - Updating existing docs ## Usage ```bash # Validate all markdown npx markdownlint-cli2 "**/*.md" # Validate specific file npx markdownlint-cli2 README.md # Fix auto-fixable issues npx markdownlint-cli2 --fix "**/*.md" ```text ## Common Issues ### MD040: Code blocks need language ````markdown # ❌ Wrong ```text code here ```text # ✅ Correct ```python code here ```text ```` ### MD031: Blank lines around code blocks ````markdown # ❌ Wrong Text before ```python code ```text Text after # ✅ Correct Text before ```python code ```text Text after ```` ### MD013: Line too long Break lines at 120 characters. ## Configuration `.markdownlint.yaml`: ```yaml line-length: line_length: 120 code_blocks: false tables: false ```text See `quality-run-linters` for complete linting workflow.