markdown-formatter

Markdown Formatter

Overview

Transform any content—plain text, web clippings, AI-generated output, or messy markdown—into clean, well-structured markdown documents. This skill intelligently analyzes content structure and applies appropriate markdown syntax to enhance readability and organization.

When to Use This Skill

Use this skill when:

• User provides content and requests markdown formatting
• Plain text needs structure and markdown syntax
• Web content or copied text needs cleanup
• AI-generated content needs proper markdown formatting
• Poorly formatted markdown needs standardization
• Lists, tables, or code blocks need proper syntax

Trigger phrases:

• "Format this as markdown"
• "마크다운으로 정리해줘"
• "Clean up this text"
• "Convert to markdown"
• "Make this markdown"

Do NOT use this skill when:

• Content is already well-formatted markdown
• User wants to preserve exact original formatting
• Request is for specialized vault formats (use cmds-doc-formatter instead)

Workflow: 6-Step Markdown Transformation

Follow these steps in order to transform any content into clean markdown:

Step 1: Analyze Content Structure

Before applying any formatting, understand the content structure by identifying:

Hierarchical elements:

• Main title (will become H1)
• Major sections (will become H2)
• Subsections (will become H3-H6)
• Logical groupings and boundaries

Content types:

• Paragraphs and body text
• Lists (ordered/unordered/nested)
• Tabular or structured data
• Code snippets or technical content
• Quotes or callouts
• Emphasis patterns (bold/italic)

Action items:

1. Read through entire content once
2. Identify the main topic and major sections
3. Note patterns that indicate structure (numbering, indentation, repetition)
4. Look for content that should be tables, lists, or code blocks
5. Identify relationships between sections

---

Step 2: Apply Heading Hierarchy

Create clear document structure with proper heading levels.

Heading rules:

• H1 (#) - Document title (only ONE per document)
• H2 (##) - Major sections
• H3 (###) - Subsections under H2
• H4 (####) - Detailed breakdowns
• H5-H6 - Rarely needed, only for very deep nesting