Skip to content

Markdown Guide

Complete syntax reference with live examples.

Headings

Markdown
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6

Heading 1

Heading 2

Heading 3

Heading 4

Heading 5

Heading 6

Emphasis

Markdown
**bold text**
*italic text*
~~strikethrough~~
**_bold and italic_**
`inline code`

bold text

italic text

strikethrough

bold and italic

inline code

Lists

Markdown
- Unordered item
- Another item
  - Nested item
  - Another nested

1. First item
2. Second item
3. Third item
   1. Nested ordered
  • Unordered item
  • Another item
    • Nested item
    • Another nested
  1. First item
  2. Second item
  3. Third item
    1. Nested ordered
Markdown
[Link text](https://example.com)
[With title](https://example.com "Title")

Reference-style:
[link text][ref]
[ref]: https://example.com

Images:
![Alt text](image.png)
![Alt text][img]
[img]: image.png "Caption"

Link text

With title

Reference-style:

link text

Images:

Alt text

Code

Markdown
Use `inline code` in prose.

```javascript
function greet(name) {
  return `Hello, ${name}!`
}
```

```python
def greet(name):
    return f"Hello, {name}!"
```

Use inline code in prose.

javascript
function greet(name) {
  return `Hello, ${name}!`
}
python
def greet(name):
    return f"Hello, {name}!"

Tables

Markdown
| Column A | Column B | Column C |
|----------|:--------:|---------:|
| Left     | Center   | Right    |
| Alpha    | Beta     | Gamma    |
| One      | Two      | Three    |
Column A Column B Column C
Left Center Right
Alpha Beta Gamma
One Two Three

Task Lists

Markdown
- [x] Completed task
- [x] Another done item
- [ ] Pending task
- [ ] Not started yet
  • Completed task
  • Another done item
  • Pending task
  • Not started yet

Blockquotes

Markdown
> A blockquote paragraph.
> It can span multiple lines.
>
> > Nested blockquote.
> > More nested content.

A blockquote paragraph.

It can span multiple lines.

Nested blockquote.

More nested content.

Mermaid Diagrams

Markdown
```mermaid
graph TD
  A[Start] --> B{Decision}
  B -->|Yes| C[Do it]
  B -->|No| D[Skip it]
  C --> E[End]
  D --> E
```

Renders as an interactive diagram in the editor. Use the mermaid language identifier in a fenced code block.

Line Numbers

Markdown
Append = after the language name
to enable line numbers:

```typescript=
interface User {
  id: string
  name: string
}
```

```python=
def calculate(x, y):
    return x + y
```

Append = after the language identifier to show line numbers:

typescript=
interface User {
id: string
name: string
}

Keyboard Shortcuts

ActionMacWindows / Linux
Bold⌘BCtrlB
Italic⌘ICtrlI
Strikethrough⌘⇧XCtrlShiftX
Inline code⌘ECtrlE
Ordered list⌘⇧7CtrlShift7
Unordered list⌘⇧8CtrlShift8
Checkbox list⌘⇧9CtrlShift9
Undo⌘ZCtrlZ
Redo⌘⇧ZCtrlShiftZ

Ready to write?

Try the editor