@@ -1100,6 +1100,35 @@ This is equivalent to:
11001100To prevent all highlighting, use the `--no-highlight` flag.
11011101To set the highlighting style, use `--highlight-style`.
11021102
1103+Line blocks
1104+-----------
1105+
1106+**Extension: `line_blocks`**
1107+
1108+A line block is a sequence of lines beginning with a vertical bar (`|`)
1109+followed by a space. The division into lines will be preserved in
1110+the output, as will any leading spaces; otherwise, the lines will
1111+be formatted as markdown. This is useful for verse and addresses:
1112+
1113+ | The limerick packs laughs anatomical
1114+ | In space that is quite economical.
1115+ | But the good ones I've seen
1116+ | So seldom are clean
1117+ | And the clean ones so seldom are comical
1118+
1119+ | 200 Main St.
1120+ | Berkeley, CA 94718
1121+
1122+The lines can be hard-wrapped if needed, but the continuation
1123+line must begin with a space.
1124+
1125+ | The Right Honorable Most Venerable and Righteous Samuel L.
1126+ Constable, Jr.
1127+ | 200 Main St.
1128+ | Berkeley, CA 94718
1129+
1130+This syntax is borrowed from [reStructuredText].
1131+
11031132Lists
11041133-----
11051134