Skip to content
All Tools

Markdown Cheatsheet

Interactive reference for every markdown syntax element. Edit any example to see it render live.

57 syntax elements
H

Headings

8

Heading 1

Largest heading — page title level.
Markdown
# Heading 1
Preview

Heading 1

Heading 2

Section heading.
Markdown
## Heading 2
Preview

Heading 2

Heading 3

Subsection heading.
Markdown
### Heading 3
Preview

Heading 3

Heading 4

Minor heading.
Markdown
#### Heading 4
Preview

Heading 4

Heading 5

Small heading.
Markdown
##### Heading 5
Preview
Heading 5

Heading 6

Smallest heading.
Markdown
###### Heading 6
Preview
Heading 6

Alt Heading 1

Alternate syntax using = underline.
Markdown
Heading 1
=========
Preview

Heading 1

Alt Heading 2

Alternate syntax using - underline.
Markdown
Heading 2
---------
Preview

Heading 2

B

Emphasis & Text

8

Bold

Wrap with double asterisks or underscores.
Markdown
**bold text**
Preview
bold text

Italic

Wrap with single asterisks or underscores.
Markdown
*italic text*
Preview
italic text

Bold + Italic

Triple asterisks for both.
Markdown
***bold and italic***
Preview
bold and italic

Strikethrough

Double tildes to cross out text.
Markdown
~~strikethrough~~
Preview
strikethrough

Highlight

Double equals for highlight (some renderers).
Markdown
==highlighted text==
Preview
highlighted text

Subscript

Tildes for subscript (extended syntax).
Markdown
H~2~O
Preview
H~2~O

Superscript

Carets for superscript (extended syntax).
Markdown
X^2^
Preview
X^2^

Inline code

Backticks for monospace inline code.
Markdown
`inline code`
Preview
inline code
🔗

Links & Images

8

Link

Text in brackets, URL in parentheses.
Markdown
[Link text](https://example.com)
Preview

Link with title

Add a title shown on hover.
Markdown
[Link](https://example.com "Title")
Preview

Auto-link

Angle brackets auto-link URLs.
Markdown
<https://example.com>

Email link

Angle brackets auto-link emails.
Markdown
<hello@example.com>
Preview
<hello@example.com>

Reference link

Define links separately for cleaner text.
Markdown
[text][1]

[1]: https://example.com
Preview
[text][1] [1]: https://example.com

Image

Like a link but with ! prefix.
Markdown
![Alt text](https://picsum.photos/200)
Preview
Alt text

Image with title

Images can also have titles.
Markdown
![Alt](https://picsum.photos/200 "Photo")
Preview
Alt

Linked image

Wrap an image in a link.
Markdown
[![Alt](https://picsum.photos/100)](https://example.com)
Preview
Alt

Lists

6

Unordered list

Use -, *, or + for bullet points.
Markdown
- Item 1
- Item 2
- Item 3
Preview
• Item 1
• Item 2
• Item 3

Ordered list

Numbers followed by period.
Markdown
1. First
2. Second
3. Third
Preview
1. First
2. Second
3. Third

Nested list

Indent with 2 or 4 spaces.
Markdown
- Item 1
  - Nested
    - Deep nested
Preview
• Item 1
• Nested
• Deep nested

Task list

Checkboxes with [ ] or [x].
Markdown
- [x] Completed
- [ ] Not done
- [ ] In progress
Preview
Completed
Not done
In progress

Definition list

Colon prefix for definitions (extended).
Markdown
Term
: Definition here
Preview
Term : Definition here

Mixed nesting

Mix ordered and unordered lists.
Markdown
1. First
   - Sub-bullet
   - Another
2. Second
Preview
1. First
- Sub-bullet - Another
2. Second
</>

Code

6

Inline code

Single backticks for inline.
Markdown
Use `console.log()` to debug
Preview
Use console.log() to debug

Code block

Triple backticks for code blocks.
Markdown
```
const x = 42;
console.log(x);
```
Preview
const x = 42;
console.log(x);

Syntax highlight

Add language after opening backticks.
Markdown
```javascript
function greet(name) {
  return `Hello, ${name}!`;
}
```
Preview
function greet(name) {
  return Hello, ${name}!;
}

Diff syntax

Use diff language for change highlighting.
Markdown
```diff
- removed line
+ added line
  unchanged
```
Preview
- removed line
+ added line
  unchanged

Indented code

4 spaces or 1 tab also creates code blocks.
Markdown
    const x = 42;
    console.log(x);
Preview
const x = 42; console.log(x);

Backticks in code

Double backticks to escape inner backticks.
Markdown
`` Use `backticks` inside ``
Preview
Use backticks inside
"

Blockquotes

6

Basic quote

Greater-than sign for quotes.
Markdown
> This is a blockquote
Preview
This is a blockquote

Multi-line

Prefix each line with >.
Markdown
> Line one
> Line two
> Line three
Preview
Line one
Line two
Line three

Nested quotes

Multiple > for nesting.
Markdown
> Outer quote
>> Nested quote
>>> Deep nested
Preview
Outer quote
Nested quote
Deep nested

Quote with content

Quotes can contain other markdown.
Markdown
> **Note:** This quote has
> 
> - A list inside
> - With items
Preview
Note: This quote has
>
- A list inside
- With items

GitHub alert: Note

GitHub-flavored alert syntax.
Markdown
> [!NOTE]
> Useful information.
Preview
[!NOTE]
Useful information.

GitHub alert: Warning

GitHub-flavored warning alert.
Markdown
> [!WARNING]
> Critical information.
Preview
[!WARNING]
Critical information.

Tables

4

Basic table

Pipes separate columns, dashes for header.
Markdown
| Name | Age |
|------|-----|
| Alice | 30 |
| Bob | 25 |
Preview
NameAge
Alice30
Bob25

Aligned table

Colons control alignment.
Markdown
| Left | Center | Right |
|:-----|:------:|------:|
| L | C | R |
| L | C | R |
Preview
LeftCenterRight
LCR
LCR

Minimal table

Outer pipes are optional.
Markdown
Name | Age
---|---
Alice | 30
Bob | 25
Preview
Name | Age ---|--- Alice | 30 Bob | 25

Formatted cells

Cells support inline formatting.
Markdown
| Feature | Status |
|---------|--------|
| **Bold** | `code` |
| *Italic* | ~~struck~~ |
Preview
FeatureStatus
Boldcode
Italicstruck

Horizontal Rules & Breaks

5

Horizontal rule (---)

Three or more dashes.
Markdown
Above

---

Below
Preview
Above
Below

Horizontal rule (***)

Three or more asterisks.
Markdown
Above

***

Below
Preview
Above
Below

Horizontal rule (___)

Three or more underscores.
Markdown
Above

___

Below
Preview
Above
Below

Line break

Two trailing spaces force a line break.
Markdown
Line 1  
Line 2
Preview
Line 1
Line 2

Paragraph break

Empty line between paragraphs.
Markdown
Paragraph 1

Paragraph 2
Preview
Paragraph 1 Paragraph 2
+

Extended Syntax

6

Footnote

Reference-style footnotes.
Markdown
Text with footnote[^1]

[^1]: Footnote content here.
Preview
Text with footnote[1] [1]: Footnote content here.

Abbreviation

Define abbreviations (some renderers).
Markdown
*[HTML]: Hyper Text Markup Language

The HTML specification.
Preview
*[HTML]: Hyper Text Markup Language The HTML specification.

Emoji shortcode

Emoji shortcodes (GitHub, Discord, etc.).
Markdown
:rocket: :fire: :star:
Preview
:rocket: :fire: :star:

Table of contents

Auto-generate TOC (some renderers).
Markdown
[[toc]]
Preview
[[toc]]

Escaped characters

Backslash escapes special characters.
Markdown
\*not italic\* \# not heading
Preview
\not italic\ \# not heading

HTML in markdown

Raw HTML works in most renderers.
Markdown
<details>
<summary>Click to expand</summary>

Hidden content here.

</details>
Preview
<details> <summary>Click to expand</summary> Hidden content here. </details>