markdown-formatter

Apply rule-based Markdown linting fixes to documentation files.

Updated Feb 5, 2026
One-click install
npx skills add https://github.com/qazuor/claude-code-knowledge --skill markdown-formatter-qazuor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-formatter
Source: https://github.com/qazuor/claude-code-knowledge/tree/main/skills/markdown-formatter
Command: npx skills add https://github.com/qazuor/claude-code-knowledge --skill markdown-formatter-qazuor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill standardizes Markdown formatting and automated fixes across documentation assets, reducing errors and improving readability.

Core Features & Use Cases

  • Rule-based formatting and automated fixes for headings, lists, code blocks, and spacing.
  • Integration with CI/CD and editor workflows to enforce consistent Markdown quality across a repository.
  • Use Case: When publishing project docs, run the formatter to automatically align headings and list indentations, ensuring a uniform style before commits.

Quick Start

Install a Markdown linting tool such as markdownlint-cli2 and run it against your docs:

  • Install: npm install -g markdownlint-cli2
  • Lint: npx markdownlint-cli2 "**/*.md"

Frequently Asked Questions about markdown-formatter

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

FAQPage Schema
How do I standardize Markdown formatting across my documentation?

You can standardize Markdown formatting by applying rule-based checks and automated fixes to headings, lists, code blocks, and spacing. This Skill analyzes documentation using a Markdown linting tool to fix violations and improve readability.

Can I enforce consistent Markdown quality in a CI/CD pipeline?

Yes, you can enforce consistent Markdown quality in a CI/CD pipeline by integrating this Skill's rule-based linting checks into your review workflows. It analyzes documentation, reports formatting violations, and applies automated fixes before commits.

What is the best way to automatically fix common Markdown style violations?

The best way to automatically fix common Markdown style violations is using a rule-based Markdown linting tool like markdownlint-cli2. This Skill leverages such tools to automatically align headings and list indentations while preserving your original content.

Does this Markdown formatter work with editor integration workflows?

Yes, this Markdown formatter works with editor integration workflows to enforce consistent documentation quality. It integrates directly into authoring and review environments to analyze, fix, and report Markdown formatting violations on the fly.

How do I run a Markdown linting tool against my project docs?

To run a Markdown linting tool against your project docs, install a CLI tool like markdownlint-cli2 via npm and execute it against your files. This Skill uses this process to apply rule-based formatting and automated fixes across your documentation.

Will automated Markdown formatting alter my actual content?

No, automated Markdown formatting will not alter your actual content. The Skill applies rule-based checks and automated fixes to standardize style violations like spacing and indentation while strictly preserving the original documentation content.