Skip to main content
Home Tools Markdown Formatter
🔧 Programming ✅ 100% Free ⚡ Instant

Markdown Formatter

Clean up and normalise Markdown documents. Fixes heading spacing, normalises list markers, aligns tables, and ensures consistent blank lines around fenced code blocks and headings.

Indent:
📥 Input
📤 Output
Ready — paste code and click Format · Ctrl+Enter to format
Lines: — Size: —
Load example: ▶ Readme ▶ Docs
📊 Stats
Lines
Size
💡 Quick Reference
# H1ATX heading
**bold**Bold text
*italic*Italic text
```Fenced code
---Horizontal rule

What is Markdown?

Markdown is a lightweight markup language created by John Gruber in 2004. It converts plain text with simple formatting syntax to HTML. Markdown is used extensively for README files (GitHub, GitLab), documentation (MkDocs, Docusaurus), blog posts (Hugo, Jekyll), and note-taking apps (Obsidian, Notion). CommonMark is the standardised specification that resolves ambiguities in the original Markdown.

Frequently Asked Questions

Original Markdown (John Gruber's spec) has many ambiguities. CommonMark is a strict, unambiguous specification that resolves them consistently. GFM (GitHub Flavored Markdown) is a superset of CommonMark that adds tables, task lists, strikethrough, and autolinks — it's what GitHub, GitLab, and many other platforms use.
ATX headings use # signs (# H1, ## H2) and are preferred by most style guides because they're explicit, consistent, and work for all six heading levels. Setext headings use underlines (=== and ---) and only work for H1 and H2. Stick with ATX for all headings.
A trailing double space followed by a newline creates a line break (<br>). However, trailing spaces are invisible and often stripped by editors. The more reliable alternative is a backslash at the end of a line, or simply using a blank line to start a new paragraph.
Done!