markdown-quality

Markdown quality guidance applies markdownlint rules with opinionated overrides to enforce consistent formatting. It requires fenced code blocks with language tags, restricts HTML to allowed elements, and integrates with markdownlint tooling to catch quality issues and auto-fix violations across your docs.

Markdownlint rules define markdown formatting standards—spacing, heading hierarchy, link syntax, code block requirements. This Skill provides a layered default configuration with selective overrides, letting teams balance readability with practicality instead of managing raw rule sets from scratch.

Yes, markdownlint includes auto-fix capabilities that resolve violations automatically. This Skill integrates that functionality, so you can apply fixes across documents rather than manually correcting each issue, while the opinionated config ensures fixes align with your team's standards.

The opinionated configuration requires fenced code blocks with language specification for readability and syntax highlighting. It permits only a curated set of HTML elements to maintain portability and consistency. Other elements must use native markdown equivalents instead.

Markdownlint reports which rules your files violate and where. This Skill provides guidance on interpreting those rule violations and applying fixes using the configured overrides, so you understand why an issue flagged and how to resolve it within your team's standards.