Block quotes¶

Indented quotes¶

A text block that is indented relative to the preceding text, without preceding markup indicating it to be a literal block or other content, is a block quote.

This is an ordinary paragraph, introducing a block quote.

    "It is my business to know things.  That is my trade."

    -- Sherlock Holmes

A block quote may end with an attribution: a text block beginning with --, ---, or a true em-dash, flush left within the block quote. If the attribution consists of multiple lines, the left edges of the second and subsequent lines must align.

Hint

Use empty comments to separate block quotes. For example:

- list item

..

    quote content

Without empty comments of .., the quote content will be treated as the content of the list item.

No attribution¶

This is an ordinary paragraph, introducing a block quote.

    "It is my business to know things.  That is my trade."

This is an ordinary paragraph, introducing a block quote.

“It is my business to know things. That is my trade.”

With attribution¶

This is an ordinary paragraph, introducing a block quote.

    "It is my business to know things.  That is my trade."

    -- Sherlock Holmes

This is an ordinary paragraph, introducing a block quote.

“It is my business to know things. That is my trade.”

—Sherlock Holmes

Multiple attributions¶

It is also possible to add multiple attributions to the quote:

This is an ordinary paragraph, introducing a block quote.

    "This is a quote message."

    -- Author 1,
       Author 2

“This is a quote message.”

—Author 1, Author 2

Multiple quotes¶

Empty comments may also be used to separate block quotes:

    Block quote.

..

    Another block quote.

Block quote.

Another block quote.

Epigraph¶

An epigraph is an apposite (suitable, apt, or pertinent) short inscription, often a quotation or poem, at the beginning of a document or section.

No attribution¶

.. epigraph::

   | Why, you may take the most gallant sailor,
   | the most intrepid airman or the most audacious soldier,
   | put them at a table together – what do you get?
   | The sum of their fears.

Why, you may take the most gallant sailor,

the most intrepid airman or the most audacious soldier,

put them at a table together – what do you get?

The sum of their fears.

With attribution¶

.. epigraph::

   | Why, you may take the most gallant sailor,
   | the most intrepid airman or the most audacious soldier,
   | put them at a table together – what do you get?
   | The sum of their fears.

   -- Winston Churchill

Why, you may take the most gallant sailor,

the most intrepid airman or the most audacious soldier,

put them at a table together – what do you get?

The sum of their fears.

—Winston Churchill

Highlights¶

Highlights summarize the main points of a document or section, often consisting of a list.

.. highlights::

   - No matter where you go, there you are. -- *Buckaroo Banzai*.
   - I have no special talent. I am only passionately curious. -- *Albert Einstein*.

No matter where you go, there you are. – Buckaroo Banzai.

I have no special talent. I am only passionately curious. – Albert Einstein.

Pull-Quote¶

A pull-quote is a small selection of text “pulled out and quoted”, typically in a larger typeface. Pull-quotes are used to attract attention, especially in long articles.

No attribution¶

.. pull-quote::

   No matter where you go, there you are.

No matter where you go, there you are.

With attribution¶

.. pull-quote::

   No matter where you go, there you are.

   -- Buckaroo Banzai

No matter where you go, there you are.

—Buckaroo Banzai