markdown-formatter

Solid

USE WHEN the user asks to clean up, reformat, or polish a markdown document. Normalizes headings, lists, tables, code fences, math delimiters, and Chinese punctuation. Returns the rewritten doc, not a description of changes.

Data & Documents 50 stars 6 forks Updated today MIT

Install

View on GitHub

Quality Score: 80/100

Stars 20%
57
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# markdown-formatter — clean and polish markdown ## When to use - "format this markdown" - "clean up this doc" - "make this look nicer" - "convert this to standard markdown" ## Rules to apply (in order) ### 1. Heading hierarchy - Exactly one `#` (H1) at top, or none. If the doc has multiple H1s, demote all but the first to H2. - No skipped levels: H2 → H3 → H4. Never H2 → H4 directly. - Add one blank line above every heading, none below. ### 2. Lists - Use `-` for unordered, never `*` or `+`. - Use `1.` `2.` `3.` for ordered (real numbers, not all `1.`). - 2-space indent for nested lists. - One blank line before and after the list block. ### 3. Tables - Pipe-style with header divider: `| h1 | h2 |\n| --- | --- |\n| a | b |` - Align with `| :--- |` (left), `| ---: |` (right), `| :---: |` (center) only when content benefits. - One space padding inside cells. ### 4. Code - Use fenced code blocks with language: ` ```python ` not just ` ``` `. - For inline code, single backticks. No triple-backtick on the same line as text. - Strip trailing whitespace inside code blocks. ### 5. Math - Display math: `$$ … $$` on its own line, with blank line above/below. - Inline math: `$…$`. Escape literal `$` as `\$`. - LaTeX commands use lowercase: `\frac` not `\Frac`. ### 6. Chinese punctuation In Chinese paragraphs, use full-width: `,。:?!""();……——`. Never mix half-width into Chinese sentences. Inside code, parameter names, URLs, or English clauses, keep half-width. ### 7. S...

Details

Author
hesorchen
Repository
hesorchen/muselab
Created
2 months ago
Last Updated
today
Language
Python
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category