markdown-formatter

Format, lint, and beautify markdown documents using configurable style guides.

39|1|Updated Jul 2, 2026
One-click install
npx skills add https://github.com/HKU-MMLab/UniClawBench --skill markdown-formatter-hku-mmlab
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: markdown-formatter
Source: https://github.com/HKU-MMLab/UniClawBench/tree/main/injection/101_skill_usage/task_101_34_video_multilang/skills/markdown-formatter
Command: npx skills add https://github.com/HKU-MMLab/UniClawBench --skill markdown-formatter-hku-mmlab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Markdown documents often accumulate inconsistent formatting: mixed list markers, irregular heading styles, trailing whitespace, and uneven spacing. This Skill normalizes and cleans markdown content automatically according to a chosen style guide, so documentation stays consistent without manual editing. ## Core Features & Use Cases - Style-Guided Formatting: Format markdown against CommonMark, GitHub Flavored Markdown, or custom rules with configurable heading, list, code block, emphasis, and link styles. - Linting & Validation: Detect heading hierarchy skips, inconsistent list markers, and other issues without modifying the source content. - Batch Processing: Format multiple markdown files in one run with per-file results, warnings, and aggregate statistics. - Use Case: You inherit a project with dozens of inconsistently formatted README and docs files. Run formatBatch with the GitHub style to normalize all of them at once and review the warnings report. ## Quick Start Ask the agent to format your markdown file with the GitHub style guide by running the markdown-formatter skill's formatMarkdown function on your document content.

Frequently Asked Questions about markdown-formatter

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

FAQPage Schema
How do I format markdown files with a specific style guide?▼

Call formatMarkdown with your markdown content and a style name such as 'commonmark' or 'github'. You can pass options like maxWidth, headingStyle, and listStyle to control wrapping, heading format, and list markers.

How to format multiple markdown files at once?▼

Use the formatBatch function with an array of file paths and a style guide name. It returns per-file results, total warnings, and processing time, and continues processing remaining files even if one file fails.

What markdown style guides does this formatter support?▼

It supports CommonMark, GitHub Flavored Markdown, a consistent style, and custom user-defined rules. GitHub style includes fenced code blocks, pipe tables, task lists, strikethrough, and autolinks.

Can I lint markdown without changing the content?▼

Yes, the lintMarkdown function checks for issues like heading level skips and inconsistent list markers without modifying the source. It returns errors, warnings, statistics, and suggestions.

Why does markdown formatting produce unexpected warnings?▼

Warnings appear when the formatter detects patterns it normalizes, such as ATX headings when a different heading style is configured or unclosed fenced code blocks. Adjust the style guide or options like headingStyle and fixLists to match your intent.