Blockquotes
Prose excerpts, quotes and verses share the same syntax structure, including:
-
block name, either
quoteorverse -
name of who the content is attributed to
-
bibliographical information of the book, speech, play, poem, etc., where the content was drawn from
-
excerpt text
Basic quote syntax
For content that doesn’t require the preservation of line breaks, set the quote attribute in the first position of the attribute list.
Next, set the attribution and relevant citation information.
However, these positional attributes are optional.
[quote, attribution, citation title and information] Quote or excerpt text
If the quote is a single line or paragraph, you can place the attribute list directly on top of the text.
.After landing the cloaked Klingon bird of prey in Golden Gate park: (1)
[quote, Captain James T. Kirk, Star Trek IV: The Voyage Home] (2) (3) (4)
Everybody remember where we parked. (5)| 1 | Mark lead-in text explaining the context or setting of the quote using a period (.). (optional) |
| 2 | For content that doesn’t require the preservation of line breaks, set quote in the first position of the attribute list. |
| 3 | The second position contains who the excerpt is attributed to. (optional) |
| 4 | Enter additional citation information in the third position. (optional) |
| 5 | Enter the excerpt or quote text on the line immediately following the attribute list. |
The result of Example 2 is displayed below.
Everybody remember where we parked.
Star Trek IV: The Voyage Home
Quoted block
If the quote or excerpt is more than one paragraph, place the text between delimiter lines consisting of four underscores (____).
[quote, Monty Python and the Holy Grail]
____
Dennis: Come and see the violence inherent in the system. Help! Help! I'm being repressed!
King Arthur: Bloody peasant!
Dennis: Oh, what a giveaway! Did you hear that? Did you hear that, eh? That's what I'm on about! Did you see him repressing me? You saw him, Didn't you?
____The result of Example 3 is displayed below.
Dennis: Come and see the violence inherent in the system. Help! Help! I’m being repressed!
King Arthur: Bloody peasant!
Dennis: Oh, what a giveaway! Did you hear that? Did you hear that, eh? That’s what I’m on about! Did you see him repressing me? You saw him, Didn’t you?
Asciidoctor also provides three alternative ways to markup quotes and prose excerpts.
Quoted paragraph
You can turn a single paragraph into a blockquote by:
-
surrounding it with double quotes
-
adding an optional attribution (prefixed with two dashes) below the quoted text
"I hold it that a little rebellion now and then is a good thing,
and as necessary in the political world as storms in the physical."
-- Thomas Jefferson, Papers of Thomas Jefferson: Volume 11The result of Example 4 is displayed below.
I hold it that a little rebellion now and then is a good thing, and as necessary in the political world as storms in the physical.
Papers of Thomas Jefferson: Volume 11
Markdown-style blockquotes
Asciidoctor supports Markdown-style blockquotes.
> I hold it that a little rebellion now and then is a good thing,
> and as necessary in the political world as storms in the physical.
> -- Thomas Jefferson, Papers of Thomas Jefferson: Volume 11The result of Example 5 is displayed below.
I hold it that a little rebellion now and then is a good thing, and as necessary in the political world as storms in the physical.
Papers of Thomas Jefferson: Volume 11
Like Markdown, Asciidoctor supports block content inside the blockquote, including nested blockquotes.
> > What's new?
>
> I've got Markdown in my AsciiDoc!
>
> > Like what?
>
> * Blockquotes
> * Headings
> * Fenced code blocks
>
> > Is there more?
>
> Yep. AsciiDoc and Markdown share a lot of common syntax already.Here’s how the conversation from Example 6 is rendered.
What’s new?
I’ve got Markdown in my AsciiDoc!
Like what?
Blockquotes
Headings
Fenced code blocks
Is there more?
Yep. AsciiDoc and Markdown share a lot of common syntax already.