Indented text block (block quote)
In reStructuredText, text blocks that are indented relative to the preceding text without explicit marking are referred to as block quotes.
Properties
- The minimum indentation is one space.
- All markup processing (for text body elements and inline markups) continues within the block quote.
Unindented paragraph. |
|
- List item. |
|
Principle
+--------------------+
|(current level of) |
|indentation) |
+--------------------+
+---------------------+
|block quote |
|(body elements) |
+---------------------+
Sample
The following sample shows nested block quotes.
(In sample project: B_DocuElements\Text blocks\FB_Libdoc_BlockQuote)
- A blank line between a text block (paragraph or block quote) and a subsequent indented text block (block quote) is optional. The indentation of the following text block causes a break at the end of the previous text block. If a blank line is inserted in the comment, the line break occurs and the blank line remains in the display.
- A blank line is automatically displayed between an indented text block (block quote) and a subsequent text block that is not indented (paragraph or block quote), regardless of whether a blank line was inserted in the comment or not. The current level of indentation is ended.
- A blank line must be inserted in the comment between two text blocks (block quotes) on the same indentation level to separate the text blocks from each other.
(*
This is a top-level paragraph.
This paragraph belongs to a first-level block quote.
This is the second paragraph of the first-level block quote.
This paragraph belongs to a second-level block quote.
Another top-level paragraph.
This paragraph belongs to a second-level block quote.
This paragraph belongs to a first-level block quote. The
second-level block quote above is inside this first-level
block quote.
*)
|
See also: