markdown-conventions

Standardize Markdown formatting for checkboxes, lists, code blocks, and links.

2|Updated Nov 12, 2025
One-click install
npx skills add https://github.com/stlwolf/ai-development-hub --skill markdown-conventions-stlwolf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-conventions
Source: https://github.com/stlwolf/ai-development-hub/tree/main/canonical/skills/markdown-conventions
Command: npx skills add https://github.com/stlwolf/ai-development-hub --skill markdown-conventions-stlwolf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Standardizes Markdown formatting across documentation by enforcing a consistent style, reducing formatting debates and improving readability.

Core Features & Use Cases

  • Enforce consistent checkboxes, bullet lists, code blocks, and links formatting.
  • Validate section structure and ensure proper spacing and indentation.
  • Use case: when creating documentation or README files, apply these rules to ensure uniform style.

Quick Start

Apply the markdown-conventions rules to new documents to ensure compliant formatting.

Frequently Asked Questions about markdown-conventions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce consistent Markdown formatting across documentation?

To enforce consistent Markdown formatting, you apply standardized rules for checkboxes, bullet lists, code blocks, and link syntax across issues, PRs, and READMEs to ensure uniform style and improve readability.

What is the best way to standardize README style and avoid formatting debates?

Standardizing README style is achieved by enforcing a consistent style guide that validates section structure, spacing, and indentation, reducing manual formatting debates and improving overall documentation readability.

Can I validate Markdown section structure and indentation in pull requests?

Yes, you can validate Markdown section structure and ensure proper spacing and indentation in pull requests by applying these conventions, which enforce uniform formatting rules for issues and PRs.

How does linting for Markdown documentation work?

Linting for Markdown documentation works by enforcing consistent style rules across documents, ensuring uniform checkboxes, bullet lists, code blocks, and links syntax while validating spacing and indentation.

Do I need a specific style guide to format Markdown code blocks and links?

You do not need an external style guide; these conventions provide the operational instructions via a Markdown body and YAML frontmatter to standardize code blocks, links, and lists formatting.