Blockquotes

A blockquote is any line that starts with >. Use it for pulled quotes, short asides, and attributions. Colored callouts are a separate thing: a quote whose first line is > [!NOTE] gets rewritten before render and comes out as an alert, so reach for Alerts when you want one of those six styles.

Quick Start

One line, one >.

Documentation is a love letter that you write to your future self.

> Documentation is a love letter that you write to your future self.

Adding Options

Formatting and paragraphs

Markdown keeps working inside the quote, and a bare > line starts a new paragraph within the same block.

Good documentation teaches, guides, and answers questions. The inline syntax is covered in Text Formatting.

— OwnDocs style guide

> **Good documentation** teaches, guides, and answers questions. The inline
> syntax is covered in [Text Formatting](/features/markdown/text-formatting).
>
> — OwnDocs style guide

Wrapped and lazy lines

Put a > on every line of the quote, wrapped lines included. Markdown does accept a lazy continuation — an unmarked paragraph line straight under a quoted line joins the same paragraph — but it's a habit worth skipping.

> First line of the quote
still inside the quote, because the line above opened one

Both lines land in the same <blockquote>. Prettier rewrites the second line with its own > the moment you save, so you may as well type it.

Advanced

Block content inside a quote

Headings, lists, thematic breaks, code fences, and tables all nest inside a quote as long as every line carries the marker.

Release policy

Every release ships three things:

1. A changelog entry
2. A migration note
3. A tagged commit

---

Bash

BashCopy

npm run build

Stage	Gate
Build	npm run build
Publish	Tag on main

> ### Release policy
>
> Every release ships three things:
>
> 1. A changelog entry
> 2. A migration note
> 3. A tagged commit
>
> ---
>
> ```bash
> npm run build
> ```
>
> | Stage   | Gate            |
> | ------- | --------------- |
> | Build   | `npm run build` |
> | Publish | Tag on `main`   |

Nested quotes

A second > nests one quote inside another. Add one marker per level.

Every example page owes the reader three things: a working snippet, the rendered result, and a code block they can copy.

Nested quotes reply to the quote above them.

A third level works too, though the indentation gets thin fast.

> Every example page owes the reader three things: a working snippet, the
> rendered result, and a code block they can copy.
>
> > Nested quotes reply to the quote above them.
> >
> > > A third level works too, though the indentation gets thin fast.

Quotes inside a list item

Indent the > two spaces under a bullet and the quote belongs to that item instead of ending the list.

• Ship the migration guide

  Readers upgrading from v1 need the rename table before anything else.

  Then link it from the changelog.

- Ship the migration guide
 
  > Readers upgrading from v1 need the rename table before anything else.
 
  Then link it from the changelog.

Options