What is Markdown? A complete beginner's guide

Markdown is a lightweight markup language created in 2004 by John Gruber and Aaron Swartz. It lets you format plain text with intuitive characters like #, *, and > — and that text is then rendered into clean HTML for display on the web.

Why Markdown won

The web is full of formatting tools, but Markdown stuck around for a few practical reasons:

• Readable as plain text — even without rendering, your .md file makes sense.
• Portable — every modern editor, static site generator, and documentation tool supports it.
• Fast to write — no mouse clicking, no nested toolbars, no surprises.
• Version control friendly — diffs in Markdown are clean and meaningful.

The five Markdown features you'll use every day

# Heading

**Bold** and _italic_ and `inline code`.

- Bulleted list
- Another item

1. Numbered list
2. Second item

[A link](https://trymarkdownviewer.com)

> A blockquote that adds emphasis.

That's it. With those five primitives you can write the vast majority of your README files, blog posts, and documentation.

Where to use Markdown

• READMEs on GitHub, GitLab, and Bitbucket
• Documentation sites like Docusaurus, MkDocs, and Mintlify
• Static blogs built with Next.js, Astro, Hugo, Jekyll, and Eleventy
• Note-taking apps like Obsidian, Bear, and Notion
• Chat platforms like Slack and Discord (with a flavored subset)

Try it now

Open the Markdown editor and paste this snippet:

# My first Markdown doc

I'm writing my **first** Markdown document. Here's a list:

- It's plain text
- It renders to HTML
- I can read it as-is

> The best way to learn is to write.

You'll see the rendered preview update as you type. From there, the Markdown cheat sheet covers everything else you'll ever need.

Markdown is one of those rare tools that's easy on day one and still useful a decade later. Welcome aboard.