markdown

What problem does it solve?

Markdown documents often suffer from inconsistent formatting, style violations, and structural errors, leading to poor readability and extra manual review time. This Skill automates the detection and correction of these issues, ensuring your markdown is always clean, consistent, and professional.

Core Features & Use Cases

• Automated Linting & Fixing: Automatically identifies and corrects common markdown style issues using markdownlint-cli2.
• Structural Issue Guidance: Provides clear instructions and examples for manually fixing complex structural problems like multiple H1 headers or emphasis used as headings.
• Customizable Rules: Easily adapt to specific project style guides by configuring rules in a .markdownlint.json file.
• Use Case: Before publishing a blog post or updating project documentation, use this Skill to automatically clean up formatting and ensure it adheres to best practices, saving you from tedious manual proofreading.

Quick Start

Please lint and auto-fix the attached 'my_document.md' file. After the auto-fix, report any remaining issues and suggest how I can manually resolve them.