#
Markdown 101
← All reads
Why bother · 4 min read

Why it's still worth learning Markdown

A format from 2004 has quietly become the default way the internet writes. That's not nostalgia — it's a design that keeps winning.

It was built around one stubborn idea

When John Gruber introduced Markdown in 2004, his rule was almost defiant: the plain-text source should be publishable as-is — readable even before anything converts it to HTML. No soup of pointy brackets, no formatting that fights the words. That single constraint is why Markdown still feels effortless two decades later. You're not learning software; you're learning a handful of marks you can already half-guess.

"The idea is that a Markdown-formatted document should be publishable as-is, as plain text, without looking like it's been marked up with tags."
— John Gruber, Daring Fireball

Plain text is a superpower, not a limitation

A Markdown file is just text. That sounds humble until you list what it buys you: the file is portable (it opens anywhere), future-proof (no proprietary format to go obsolete), version-controllable (tools like Git can track every change line by line), and readable without any special software — you can open it in Notepad and still understand it. You aren't renting space in someone's app. The document is yours, in a form that will still open in fifty years.

Learn it once, use it almost everywhere

The same little syntax — # heading, **bold**, - list — works on GitHub, Reddit, Stack Overflow, Discord, countless wikis, and a generation of note apps. Write once, and the muscle memory follows you across the web. Few skills this small pay off in this many places.

~10 min
to learn the core marks
20+ yrs
and more popular than ever
1 file
that outlives any app

It becomes HTML so you don't have to write HTML

Gruber's original tool was a Perl script that turned Markdown into clean, valid HTML. That's still the deal today: you write the easy version, and a parser produces the markup a browser needs. You get the structure of HTML — headings, links, lists, emphasis — without typing a single <tag>.

And now the machines speak it too

Here's the twist nobody planned: Markdown became a favorite output format for AI language models. Ask a modern chatbot a question and the headings, bold terms, and bullet lists you see are usually Markdown under the hood. A format invented so humans wouldn't have to think about formatting turned out to be exactly how machines like to hand structure back to us. Learning it now isn't looking backward — it's reading the language of the tools you'll use tomorrow.

The payoff is huge for how little there is to learn.
Start lesson 1 →
Sources: John Gruber, Daring Fireball (Markdown project & syntax docs, 2004); CommonMark.org; Wikipedia, "Markdown." Facts on portability, history, and AI usage drawn from these.