doc-validate-markdown

Markdown validation checks for style and formatting issues like line length, code block formatting, trailing whitespace, and blank lines around blocks. This Skill uses markdownlint-cli2 to automatically identify violations, ensuring consistent, professional documentation before commits.

Yes, this Skill integrates markdown linting as a pre-commit hook or CI step to catch formatting errors early. Configure rules via .markdownlint.yaml to enforce project standards and prevent non-compliant documentation from merging.

The Skill enforces language-tagged code blocks, maximum line length of 120 characters, no trailing whitespace, final newlines, and proper blank lines around blocks. Common errors like MD040, MD031, MD013, and MD022 are detected with guidance for correction.

Run the validation to identify issues, then review the error codes and descriptions provided. Configure .markdownlint.yaml to adjust rules as needed, and reformat files to match requirements like line length and code block syntax.

Yes, .markdownlint.yaml configuration allows customization of rules and thresholds to match your project's documentation standards, making the validation flexible across different teams and style guides.

Apply markdown validation as an automated check before commits and in CI/CD pipelines. This catches formatting issues early, reduces manual review overhead, and maintains consistent documentation quality across contributors.