Markdown Won. Here's Why - and How to Speak It

Markdown is what you type into a chat and what the model types back. It’s what every README, every agent-instruction file, every note you’ll actually find again in two years is written in. That isn’t a fluke of fashion. Markdown won the way the cockroach won: not by being the most advanced thing in the room, but by being impossible to kill.

It’s worth sitting with how little Markdown does. There’s no Markdown app you have to buy. No premium tier, no version that goes obsolete and strands your files on a dead hard drive. A heading is a #. Bold is two asterisks. That’s not a missing feature set, that’s the entire point. While word processors spent thirty years growing ribbons, side panes, and a haunted basement of XML you can’t open without exactly the right software, Markdown sat in the corner being plain text. Then the machines showed up, and it turned out the corner was the throne.

There’s a Devo-shaped joke in here, and I say that as a man with the vanity plate. De-evolution: the notion that going backward, getting simpler, refusing the upgrade, is sometimes the smarter adaptation. Markdown is de-evolved writing. It gave up on being impressive and accidentally became the one format everything speaks.

Why it won

• It’s just text. No proprietary format, nothing to license, no app that has to still exist in 2040. Openable in anything, forever.
• Readable both ways. The raw file is legible to a human; rendered, it’s clean. You never have to pick one.
• Diff-friendly. It plays perfectly with git. You can see exactly what changed, word by word, which a binary .docx will never show you.
• Renders everywhere. GitHub, this site, your notes app, the chat window. The same five characters work on every surface.
• It’s the language the models think in. LLMs were trained on mountains of the stuff, so they read and write it natively. Talk to a model in Markdown and you aren’t translating; you’re speaking its first language.

That last one is why this matters now, and not just to tidy people. The lingua franca between you and an AI turned out to be the format that barely qualifies as one. Of course it did. The path of least friction usually wins, and there is nothing with less friction than text that already looks fine before anything renders it.

The basics you actually need

You can learn the entire working vocabulary in about the time it takes to read this list.

• Headings: #, ##, ###, on down as you nest.
• Emphasis: *italic*, **bold**.
• Lists: - for bullets, 1. for numbered.
• Links and images: [text](url) and ![alt](url).
• Code: `inline` and triple-backtick fenced blocks (name the language for syntax highlighting).
• Blockquotes: start the line with >.
• Tables: pipes and dashes, which nobody enjoys typing and everybody copies from an example.

That’s the language. The rest is flavor.

See it work

Talk is cheap. Here is a scrap of raw Markdown source:

**Markdown** reads two ways. As a list:

- raw, like this
- or rendered, like below

> A blockquote is just a line that starts with a greater-than sign.

And here is that exact scrap, handed to the same site you’re reading right now:

Markdown reads two ways. As a list:

• raw, like this
• or rendered, like below

A blockquote is just a line that starts with a greater-than sign.

Same characters, two faces. You could have read the source and known precisely what you were getting. Try that with a .docx.

There’s one place Markdown stops dressing things up entirely: the fenced code block. Triple backticks tell the renderer to keep its hands off and show every glyph exactly as typed, whitespace and all. It’s how code stays code. It’s also the only reason ASCII art survives contact with a formatter, which is the only reason I can show you a glitch-koan from LOUUY (a 7-billion-parameter model I fine-tuned into a character and keep on my laptop) without it getting “helpfully” reflowed into mush:

L O U U Y
L O U U Y
L O U I . Y
L O . . Y
 .   .   .
they don't hallucinate. they crash.
show me the file.

Outside those backticks, Markdown would flatten that spacing on sight. Inside them, the glitch is preserved exactly, because the format finally agreed to stop helping.

Where to go from here

• Flavors. CommonMark is the strict spec; GitHub-Flavored Markdown adds the parts you actually reach for (task lists, tables, strikethrough). When people say “Markdown,” they usually mean GFM.
• Front matter. The +++ or --- block at the top of a file, where the metadata lives. It’s how this very post knows its own title. Scroll to the top of any file on this site and you’ll see one.
• When not to. Markdown is for structured prose. The moment you need real page layout, fussy typography, or someone’s brand guidelines honored to the pixel, pick up the heavy tool and don’t feel guilty about it.

Markdown didn’t win because it’s powerful. It won because it’s humble, legible, and refuses to die, and then the most powerful machines we’ve ever built turned out to prefer it too. De-evolution, one # at a time.