skills.rest
sebaperiesdigit-create
sebaperiesdigit-createCOMMUNITY
Explore all skills by this author →
GitHub

markdown-document-formatter

Cleans and standardizes Markdown files by fixing headings, lists, tables, and code fences.

Updated Jul 27, 2026
Search Tags:#linting#documentation#markdown#formatting#cleanup#code fences#heading structure
One-click install
npx skills add https://github.com/sebaperiesdigit-create/Peries-Skills-Master --skill markdown-document-formatter-sebaperiesdigit-create
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: markdown-document-formatter
Source: https://github.com/sebaperiesdigit-create/Peries-Skills-Master/tree/main/.claude/skills/markdown-document-formatter
Command: npx skills add https://github.com/sebaperiesdigit-create/Peries-Skills-Master --skill markdown-document-formatter-sebaperiesdigit-create

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Messy Markdown files with inconsistent heading levels, mixed list markers, broken tables, and unclosed code fences are hard to read and review. This Skill normalizes formatting without changing any content or meaning. ## Core Features & Use Cases - Heading Hierarchy Repair: Detects skipped or inconsistent heading levels and reorders them into a logical sequence without altering wording. - Syntax Standardization: Unifies list markers, normalizes spacing, repairs malformed tables and links, and fixes code block fencing with language identifiers where unambiguous. - Safe Output Workflow: Shows the cleaned document and a fix summary in chat first, then saves to a new -formatted.md file only after explicit user confirmation. - Use Case: Before submitting a README for team review, run this Skill to fix its formatting issues and get a clean copy alongside the original. ## Quick Start Format the Markdown file at docs/README-draft.md and show me a summary of the fixes before saving.

Frequently Asked Questions about markdown-document-formatter

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

FAQPage Schema
How do I fix inconsistent heading levels in a Markdown file?▼

Provide the file path or paste the Markdown text, and the Skill analyzes heading structure for skipped levels like jumping from # to ###. It reorders headings into a logical sequential hierarchy without changing any wording.

How to standardize mixed list markers in Markdown?▼

The Skill detects mixed list markers such as -, *, and + throughout a document and converts them all to a single consistent style. This is applied uniformly across the entire file while preserving list content and nesting.

Does Markdown formatting change my document content?▼

No, the Skill only fixes formatting and syntax issues. It never rewrites, summarizes, or shortens content, and it does not change the meaning of headings or text. Ambiguous issues are flagged for manual review instead of being guessed.

Will this overwrite my original Markdown file?▼

No, the original file is never overwritten. The cleaned version is shown in chat first, and a new file like README-formatted.md is saved alongside the original only after you explicitly confirm.

What happens with broken code blocks or unfixable syntax?▼

The Skill ensures every opening code fence has a matching closing fence, standardizes on triple-backtick fences, and adds language identifiers when unambiguous. Syntax that cannot be safely auto-fixed is flagged as a manual review item.

Related Skills

Explore More Content & Communication Skills→
tyl-99tyl-99

mdwrite

Generate markdown files from user instructions with specified filenames.

Community
Basic
DojoGenesisDojoGenesis
2

pdf-export

Convert Markdown, HTML, chat JSON, and Dojo files to typeset PDFs with syntax highlighting and themes.

Community
Intermediate
dredd-usdredd-us

markdown-formatter

Format and lint Markdown documents with heading, list, code block, and link rules.

Official
Basic
radius-projectradius-project
1.7k

radius-markdown-lint

Lint and fix Markdown files using markdownlint-cli2 and markdown-table-formatter.

Official
Intermediate