Markdown Is for Humans
The article argues that Markdown's primary value lies in being human-readable and writable in plain text, not in its rendering to HTML. It contends that focusing on visual output misses the point, as Markdown is designed for writing and editing efficiency, not for producing pixel-perfect documents.
Background
- Markdown is a lightweight markup language created in 2004 by John Gruber (with help from Aaron Swartz) that lets writers format text using simple, readable symbols like asterisks and hashes, rather than the complex tags required by HTML.
- This post argues that Markdown's original philosophy — making text easy for *people* to read and write in its raw form — is being undermined as tools and platforms add features like custom syntax, WYSIWYG editors, or export-only workflows that treat the plain-text source as an intermediate format rather than the primary one.
- The distinction matters because Markdown's simplicity and portability made it a standard for note-taking, documentation, and web writing; when tools hide or extend it, they risk locking content into proprietary formats or requiring users to learn tool-specific dialects, contradicting the format's original human-first purpose.