Markdown

Updated 2026-04-08

A text-formatting language and conversion tool developed by John Gruber in 2004. The core idea is that text should remain readable and pleasant as plain text, without HTML tags or proprietary formats. A Markdown document should be publishable as-is.

What Makes Markdown Special

Before Markdown, writing for the web was a trade-off: either WYSIWYG editors that produced unreadable HTML soup, or raw HTML that only developers wanted to touch. Gruber’s key insight was that good plain-text email already contains markup. Asterisks for emphasis, underscores for code, # headings for structure.

Markdown formalized those natural conventions into a syntax that is:

  • Human-readable without rendering - a Markdown file is understandable even without preview
  • Easy to write - no angle brackets, no closing tags
  • Convertible to valid HTML - immediately usable on the web

Adoption and Variants

Markdown was originally published as a Perl script. Today there are hundreds of implementations and dialects:

  • CommonMark - an attempt at a standardized specification
  • GitHub Flavored Markdown (GFM) - adds tables, strikethrough, and task lists
  • Obsidian Markdown - extends it with wikilinks, callouts, and YAML frontmatter

Its adoption is enormous: GitHub, GitLab, Stack Overflow, Slack, Discord, WhatsApp in part, nearly all static site generators, Obsidian, Notion internally, Linear, Bear. Almost all of them use Markdown or a close variant.

Markdown as Philosophy

Markdown is more than syntax. It is an argument: text should belong to you. A .md file is readable in any editor, does not require a specific app, and will still be readable in 20 years. That is the core of the File over App idea and one of the main reasons Obsidian chose Markdown as its native format.

“A Markdown-formatted document should be publishable as-is, as plain text, without looking like it’s been marked up with tags or formatting instructions.”

Connections

  • John Gruber - inventor; Daring Fireball was his main project, Markdown his most durable contribution
  • File over App - Markdown is the natural syntax for long-lived, portable files
  • Obsidian - uses Markdown as its native format and extends it with wikilinks and YAML frontmatter
  • Aaron Swartz - helped shape early Markdown syntax

Sources

  • Daring Fireball: Markdown - official introduction on daringfireball.net (2026-04-05)