What Is Markdown? A Beginner's Guide with Cheat Sheet

If you have ever written a GitHub README, posted on Reddit, or used a modern note-taking app, you have probably used Markdown — perhaps without knowing its name. Markdown is a simple way to format plain text using symbols you already type, which then render as clean, styled content. It has quietly become the default writing format for developers, technical writers, and note-takers everywhere. Here is everything you need to start using it today.

Why Markdown exists

Before Markdown, formatting text on the web meant writing HTML — verbose tags like <strong> and <a href> that clutter the text and slow you down. In 2004, John Gruber created Markdown with a simple goal: a format that is readable as-is, even before it is rendered. You write **bold** instead of <strong>bold</strong>, and the source stays clean and human-friendly.

The essential syntax

Here is the core of Markdown — enough to handle the vast majority of real writing:

# Heading 1
## Heading 2
### Heading 3

**bold text**   and   *italic text*

- bullet list item
- another item

1. numbered list
2. second item

[link text](https://example.com)

![image alt text](image.jpg)

> a blockquote

`inline code`   and a code block:

```
multiple lines
of code
```

The rules that trip people up

Markdown is forgiving, but a few quirks cause most beginner frustration:

• Headings need a space. # Title works; #Title does not render as a heading.
• Blank lines matter. Put an empty line before a heading or list, or it may merge with the paragraph above it.
• Two spaces for a line break. A single newline inside a paragraph is usually ignored; end a line with two spaces to force a break.
• Lists need consistency. Mixing - and * bullets in the same list can break the rendering.

Flavors of Markdown

The original spec left some gaps, so platforms extended it. The most important variant is GitHub Flavored Markdown (GFM), which adds tables, task lists (- [ ] checkboxes), strikethrough (~~text~~), and automatic links. CommonMark is a separate effort to standardize the core. In practice, if you stick to the essential syntax above, your text renders correctly almost everywhere.

Where Markdown is used

• Documentation: README files, wikis, and static-site generators all run on Markdown.
• Notes: apps like Obsidian, Notion, and many others use it as their writing layer.
• Communication: Reddit, Discord, Slack, and Stack Overflow all accept Markdown.
• Blogging: most developer-focused publishing platforms accept Markdown directly.

The best way to learn

Markdown clicks fastest when you see your text render live as you type. The preview tool below shows your Markdown source on one side and the formatted result on the other, instantly — ideal for drafting a README or checking a tricky table before you commit it.