The Dead Simple Markdown Guide to Blockquotes

Written by typesetting | Published 2024/08/20
Tech Story Tags: markdown | markdown-syntax | text-formatting | markdown-guide | markdown-blockquotes | markdown-formatting | markdown-best-practices | markdown-quote-formatting

TLDR In Markdown, create blockquotes by adding > before a paragraph. For multiple paragraphs, add > to the blank lines between them. To nest blockquotes, use >>. You can also include other Markdown elements within blockquotes. Ensure to add blank lines before and after blockquotes for compatibility.via the TL;DR App

Blockquotes

To create a blockquote, add a > in front of a paragraph.

> Dorothy followed her through many of the beautiful rooms in her castle.

The rendered output looks like this:

Dorothy followed her through many of the beautiful rooms in her castle.

Blockquotes with Multiple Paragraphs

Blockquotes can contain multiple paragraphs. Add a > on the blank lines between the paragraphs.

> Dorothy followed her through many of the beautiful rooms in her castle.
>
> The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.

The rendered output looks like this:

Dorothy followed her through many of the beautiful rooms in her castle.

The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.

Nested Blockquotes

Blockquotes can be nested. Add a >> in front of the paragraph you want to nest.

> Dorothy followed her through many of the beautiful rooms in her castle.
>
>> The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.

The rendered output looks like this:

Dorothy followed her through many of the beautiful rooms in her castle.

The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.


Blockquotes with Other Elements

Blockquotes can contain other Markdown formatted elements. Not all elements can be used — you’ll need to experiment to see which ones work.

> #### The quarterly results look great!
>
> - Revenue was off the chart.
> - Profits were higher than ever.
>
>  *Everything* is going according to **plan**.

The rendered output looks like this:

The quarterly results look great!

  • Revenue was off the chart.
  • Profits were higher than ever.

Everything is going according to plan.

Blockquotes Best Practices

For compatibility, put blank lines before and after blockquotes.

✅ Do this

❌ Don't do this

Try to put a blank line before...

> This is a blockquote

...and after a blockquote.

Without blank lines, this might not look right.
> This is a blockquote
Don't do this!

This guide is a Matt Cone project available on Markdown Guide under the CC BY-SA 4.0 license.


Written by typesetting | Shaping readable and sustainable publications.
Published by HackerNoon on 2024/08/20