tech, simplified.

The Quick Guide to Markdown

Want to format text? It’s insanely easy in most word processors, email apps, and anywhere else you'd type formatted text today. You type text, select it, then tap the B icon to make it bold or the i to italicize it. Need a list? There's a ☰ button for that, too.

So you're good.

That is unless you want to format plain text. Then you'll need a bit more to make your plain text less plain. You need Markdown.

Over a century after the typewriter turned handwriting into precise characters, we've collectively found the symbols and characters that work best to format plain text. That's Markdown in a nutshell—it's a simple way to format text using symbols, similar to the way you'd use symbols to add character to a typewritten document.

How to Write in Markdown

You write text as normal, then add special characters before (and sometimes after) the word or phrase to format them. Wrap a word in *asterisks* or _underscores_ to italicize it, for instance; add two ## hashtags before a phrase to make it an H2-sized title.

Here are the most common Markdown formatting characters you'll use:

That's the basics. Markdown is simple and doesn't clutter your document much. As John Gruber said in Markdown's original documentation, “Markdown is intended to be as easy-to-read and easy-to-write as is feasible.”

It does pretty well at keeping that promise.

That’s all you need to start formatting text with Markdown. You can find more details in the Markdown documentation if you want to get fancy and add tables and footnotes and more.

For now, though, practice makes perfect. Start formatting your text with _underscores_ and # hashtags and it'll quickly become second nature.

Thoughts? @reply me on Twitter.