md-workflow

What problem does it solve?

This skill provides a complete workflow for creating, editing, and linting Markdown files with YAML frontmatter awareness, reducing formatting errors and speeding up documentation tasks.

Core Features & Use Cases

• Create: Set up new Markdown files with proper YAML frontmatter structure and headings.
• Edit: Modify existing Markdown with correct patterns and maintain frontmatter integrity.
• Lint: Validate and auto-fix Markdown formatting according to configured rules.
• YAML Frontmatter: Enforce best practices for frontmatter structure, including pattern choices to avoid MD025 duplicates.
• Use Case: A documentation team wants to publish consistent Markdown posts across a repo with validated frontmatter.

Quick Start

Use the md-workflow command to initialize and lint a sample Markdown file in your project. For example: Create a new file docs/sample.md with frontmatter and an H1 in content and run the lint steps described in the Quick Reference.