MD ViewerMD Viewer

100% private — everything runs in your browser

Markdown Block Quote

Multiline, nested, and mixed with Markdown inside — build a markdown block quote layer by layer and watch each level render live.

MD Viewer Team

Examples
Markdown source
Preview

Line one of the quote Line two of the quote

A markdown block quote is the full-featured form of Markdown quoting: multiple lines, multiple paragraphs, nesting with > >, and any Markdown construct — lists, emphasis, code — living inside the quoted block. Where a one-line quote is a sentence with a marker, a markdown block quote is a container. The playground above loads multiline and nested examples side by side with their rendered output, and every edit re-renders instantly.

The container nature is what makes the markdown block quote powerful and tricky. Because each line of the quote carries its own > marker, a quote can span paragraphs without closing, nest a quote inside a quote for citation-of-citation, and embed a list that stays visually inside the quote. The Mixed example shows the combination: bold text and a bulleted list, all inside one markdown block quote, all rendered as part of it.

This page is the advanced companion to the markdown quote page, which teaches the basic > syntax. Here you will find the nesting rules, the paragraph behavior of blank > lines, the lazy-continuation gotcha that silently swallows unmarked lines, and the mistakes that break a complex markdown block quote when it crosses a paragraph boundary.

Markdown block quote syntax reference

You typeWhat renders
> A > BOne markdown block quote containing two lines
> A > > BOne quote with two paragraphs inside
> > innerA nested markdown block quote, one level deep
> > > deeperTwo levels of nesting
> - itemA list rendered inside the quote block
> ```code```A fenced code block inside the quote

How to build a markdown block quote

  1. 1

    Mark every line

    Start each line of the markdown block quote with > and a space. Marking every line — rather than only the first — keeps the quote robust across paragraphs and renderers.

  2. 2

    Split paragraphs with a bare >

    A line containing only > is a paragraph break inside the quote. The markdown block quote stays open, and the next > line starts a new paragraph within the same container.

  3. 3

    Nest by stacking markers

    Write > > to nest. Each additional marker deepens the markdown block quote one level; the Multiline and Nested examples above let you feel the indent levels stack.

  4. 4

    Put real Markdown inside

    Lists, headings, emphasis, and code fences all work inside a markdown block quote when they follow the > marker. The Mixed example demonstrates the pattern cleanly.

Nested quotes, attribution chains, and structure

Nesting is where the markdown block quote earns its keep. An article quoting an expert who quoted a study is two levels: the outer > holds your commentary or the journalist's framing, the inner > > holds the original words. Email threads are the same structure compressed — each reply level is one more marker. Renderers keep the visual nesting through progressive indentation, so a reader can follow who said what without tracking markers in the source.

The rule that trips people is the paragraph boundary inside quotes. A fully blank line closes the paragraph but not the quote — the next > line reopens it as a new paragraph of the same markdown block quote. A fully unmarked text line after a quote paragraph is the lazy continuation: it folds into the quote's last paragraph. That convenience becomes a bug when unrelated prose accidentally follows a quote; when you want out, leave a blank line and write without markers.

For documents where quoting carries weight — legal briefs, academic writing, curated discussions — the markdown block quote pairs well with export: the convert md to pdf page preserves the nesting indentation and the accent styling, so a two-level quote in the preview is a two-level quote on paper. Combined with the md markup editor for drafting, you can build and verify the whole chain before it ships.

Markdown block quote mistakes

> Quote unmarked line

> Quote > marked line

The unmarked line becomes a lazy continuation — it renders inside the markdown block quote. Mark every line you want quoted.

> Outer > inner (one marker)

> Outer > > inner (two markers)

One marker keeps both lines at the same level. Nesting a markdown block quote requires stacking > > on the inner lines.

> > deep > > deeper > back (one marker)

> > deep > > deeper > back after nesting closes

Dropping from > > to > closes the inner level and continues the outer quote — it does not exit the quote. A blank unmarked line exits.

Block quotes are containers, not styling

Use a markdown block quote when the words belong to someone else or must read as a unit. If you just want a highlighted box, a callout heading or bold text is lighter — a page made entirely of nested quotes buries the actual prose.

Frequently asked questions

Sources and spec citations

“A block quote marker consists of 0-3 spaces of initial indent, plus (a) a character > followed by a space, or (b) a single character > not followed by a space.”
CommonMark Specification 0.31.2
“Markdown is a text-to-HTML conversion tool for web writers.”
John Gruber, "Markdown" project page (Daring Fireball)

Related Markdown tools