Additional Blocks

Quotes and Verses

In addition to the blocks already introduced, AsciiDoc offers more useful block types for special content.

Quotes (blockquotes) are used for statements from other people:

[quote, Albert Einstein]
____
Imagination is more important than knowledge.
____

Imagination is more important than knowledge.

— Albert Einstein

You can also specify a source:

[quote, Albert Einstein, Letter to a friend]
____
Imagination is more important than knowledge.
____

Verses are suitable for poems or song lyrics where line breaks should be preserved:

[verse, William Shakespeare, Hamlet]
____
To be, or not to be, that is the question:
Whether 'tis nobler in the mind to suffer
The slings and arrows of outrageous fortune,
Or to take arms against a sea of troubles.
____

Sidebars and Examples

Sidebars highlight supplementary information:

.Background Information
****
This text appears in a sidebar and is suitable
for additional information that should not
interrupt the reading flow.
****
Background Information

This text appears in a sidebar and is suitable for additional information that should not interrupt the reading flow.

Example blocks mark examples:

.An Example
====
Here is a detailed example with multiple paragraphs.

It can also contain lists:

* Point 1
* Point 2
====

Open Blocks and Literal Blocks

Open blocks are flexible containers that group different content:

--
This block can contain anything.

Even multiple paragraphs and other elements.
--

They are often used for complex list content (see Lists).

Literal blocks display text exactly as entered – without formatting:

....
This text is displayed    exactly like this,
    including spaces and
        indentation.
....
This text is displayed    exactly like this,
    including spaces and
        indentation.
The adoc Coach shows you all available block types. Press ESC and search for "Block".
For a complete overview of all blocks, check the Manual.