Cheat sheetDocs
Markdown syntax
All of everyday Markdown on one sheet — headings, emphasis, lists, links, images, code and tables — each with what it renders as.
Last updated
Headings & emphasis
| You type | You get |
|---|---|
| # Title / ## Section | Heading level 1 / level 2 — one # per level, up to six. |
| **bold** | Bold text. |
| *italic* | Italic text. |
| ~~struck~~ | Strikethrough (GitHub-flavoured). |
| `code` | Inline code in a monospace chip. |
Lists & quotes
| You type | You get |
|---|---|
| - item | A bulleted list; indent two spaces to nest. |
| 1. item | A numbered list — the numbers self-correct, so 1. everywhere works. |
| - [ ] task / - [x] done | Checkboxes (GitHub-flavoured task list). |
| > quoted line | A blockquote; stack the > for nesting. |
Links & images
| You type | You get |
|---|---|
| [text](https://url) | A link with custom text. |
|  | An image — the leading ! is the whole difference from a link. |
| <https://url> | A bare auto-link, shown as-is. |
Code blocks
| You type | You get |
|---|---|
| ```js … ``` | A fenced code block; the word after the fence sets syntax highlighting. |
| four spaces | The old-style indented code block — fences are clearer, prefer them. |
Tables & extras
| You type | You get |
|---|---|
| | a | b | with | --- | --- | | A table: header row, then a divider row of dashes, then data rows. |
| | :--- | :---: | ---: | | Column alignment in the divider — left, centre, right. |
| --- | A horizontal rule, on its own line with blank lines around it. |
| Two trailing spaces | A line break WITHIN a paragraph (or end the line with a backslash). |
Worth remembering
- →Blank lines matter more than anything else: most "broken" Markdown is a missing empty line before a list, table or fence.
- →Preview any of this live in the Markdown Preview tool — type on the left, rendered result on the right.