SGML

Note: To produce HTML from the example markdown sources, copy and paste an example source, store it into a file with the ".md" file extension, and invoke

sgmlproc <your-file.md>

where <your-file.md> is replaced by the actual file used for storing.

This demonstrates a basic block quote
> beginning at the current indentation level

Pandoc won't format it as block quote, needing
a blank line before by default.

<p>This demonstrates a basic block quote
</p><blockquote><p>beginning at the current indentation level
</p></blockquote><p>Pandoc won't format it as block quote, needing
a blank line before by default.
</p>

This demonstrates a basic block quote

> beginning at the current indentation level

that is also recognized by Pandoc by default.

<p>This demonstrates a basic block quote
</p><blockquote><p>beginning at the current indentation level
</p></blockquote><p>that is also recognized by Pandoc by default.
</p>

This is a test for

>>nested
>blockquotes

markdown.pl/pandoc treat the 2nd line as continuation to
the nested block quote starting in the 1st line and will
discard the `>` prefix on it.

<p>This is a test for
</p><blockquote><blockquote><p>nested
blockquotes
</p></blockquote></blockquote><p>markdown.pl/pandoc treat the 2nd line as continuation to
the nested block quote starting in the 1st line and will
discard the <code>&#62;</code> prefix on it.
</p>

This

>  > tests nested
> block quotes

which use blockquoting chars with two spaces.

<p>This
</p><blockquote><blockquote><p>tests nested
block quotes
</p></blockquote></blockquote><p>which use blockquoting chars with two spaces.
</p>

This

>   > tests nested
> block quotes

which use blockquoting chars with three spaces.

<p>This
</p><blockquote><blockquote><p>tests nested
block quotes
</p></blockquote></blockquote><p>which use blockquoting chars with three spaces.
</p>

This

>    > tests nested
> block quotes

which use blockquoting chars with a quadspace.

<p>This
</p><blockquote><blockquote><p>tests nested
block quotes
</p></blockquote></blockquote><p>which use blockquoting chars with a quadspace.
</p>

This

>	> tests nested
> block quotes

which use blockquoting chars with a tab.

<p>This
</p><blockquote><blockquote><p>tests nested
block quotes
</p></blockquote></blockquote><p>which use blockquoting chars with a tab.
</p>

This

> 	> tests nested
> block quotes

which use blockquoting chars with a space followed by a tab.

<p>This
</p><blockquote><blockquote><p>tests nested
block quotes
</p></blockquote></blockquote><p>which use blockquoting chars with a space followed by a tab.
</p>

This

>  	> tests nested
> block quotes

which use blockquoting chars with two spaces followed by a tab.

<p>This
</p><blockquote><blockquote><p>tests nested
block quotes
</p></blockquote></blockquote><p>which use blockquoting chars with two spaces followed by a tab.
</p>

This is a test for

> a blockquote starting at top-level
> > and continuing at a nested level

(in contrast to blockquote1-13, which start at
a nested level and continue with top-level).
Note that pandoc needs the `--strict` option
to render the nested block quote (without it, pandoc
will render the nested block quote as continuation
line).

<p>This is a test for
</p><blockquote><p>a blockquote starting at top-level
</p><blockquote><p>and continuing at a nested level
</p></blockquote></blockquote><p>(in contrast to blockquote1-13, which start at
a nested level and continue with top-level).
Note that pandoc needs the <code>--strict</code> option
to render the nested block quote (without it, pandoc
will render the nested block quote as continuation
line).
</p>

This is a test for

> a blockquote starting at top-level
>
> > and continuing at a nested level

where there's a blank line in the quoted block
which is required for pandoc in default mode
so that the line containing "and continuing ..."
isn't regarded as continuation line.

<p>This is a test for
</p><blockquote><p>a blockquote starting at top-level
</p><blockquote><p>and continuing at a nested level
</p></blockquote></blockquote><p>where there's a blank line in the quoted block
which is required for pandoc in default mode
so that the line containing "and continuing ..."
isn't regarded as continuation line.
</p>

This is a test for

> a blockquote starting at top-level
> > then opening a nested level
> > further continuing at the nested level
> > > then opening a doubly-nested level
> > > further continuing at the doubly-nested level
> > >
> > then returning to the simply-nested level
> >
> then returning to the top-level blockquote.

markdown.pl doesn't close a blockquote before
"then returning to the simply-nested level"; it
does close a blockquote level before
"then returning to the top-level blockquote",
and closes two blockquote levels after the
blockquote section.

Compare this to blockquote31.txt, where blank lines
are part of the blockquote being returned to,
rather than being closed as here. 

NOTE:
markdown.awk doesn't treat this as markdown.pl does:
markdown.awk doesn't differentiate between whether a
blank line occurs in the blockquote being closed or
in the blockquote being returned to, so formats this
same as blockquote31.txt (which shows the recommended,
portable way to exit from a nested blockquote).

The reason is that markdown.pl's behaviour isn't
documented, and seems merely an implementation
artifact.

<p>This is a test for
</p><blockquote><p>a blockquote starting at top-level
</p><blockquote><p>then opening a nested level
further continuing at the nested level
</p><blockquote><p>then opening a doubly-nested level
further continuing at the doubly-nested level
</p></blockquote><p>then returning to the simply-nested level
</p></blockquote><p>then returning to the top-level blockquote.
</p></blockquote><p>markdown.pl doesn't close a blockquote before
"then returning to the simply-nested level"; it
does close a blockquote level before
"then returning to the top-level blockquote",
and closes two blockquote levels after the
blockquote section.
</p><p>Compare this to blockquote31.txt, where blank lines
are part of the blockquote being returned to,
rather than being closed as here. 
</p><p>NOTE:
markdown.awk doesn't treat this as markdown.pl does:
markdown.awk doesn't differentiate between whether a
blank line occurs in the blockquote being closed or
in the blockquote being returned to, so formats this
same as blockquote31.txt (which shows the recommended,
portable way to exit from a nested blockquote).
</p><p>The reason is that markdown.pl's behaviour isn't
documented, and seems merely an implementation
artifact.
</p>

This is a test for

> a blockquote starting at top-level
> > then opening a nested level
> > further continuing at the nested level
> > > then opening a doubly-nested level
> > > further continuing at the doubly-nested level
> >
> > then returning to the simply-nested level
>
> then returning to the top-level blockquote.

markdown.pl needs the blank lines as shown or wouldn't
return to the simply-nested (level 2) nesting level at
"then returning to the simply-nested level" nor to
the level 1 blockquote at "then returning to the
top-level blockquote" (cf. blockquote30.txt).

<p>This is a test for
</p><blockquote><p>a blockquote starting at top-level
</p><blockquote><p>then opening a nested level
further continuing at the nested level
</p><blockquote><p>then opening a doubly-nested level
further continuing at the doubly-nested level
</p></blockquote><p>then returning to the simply-nested level
</p></blockquote><p>then returning to the top-level blockquote.
</p></blockquote><p>markdown.pl needs the blank lines as shown or wouldn't
return to the simply-nested (level 2) nesting level at
"then returning to the simply-nested level" nor to
the level 1 blockquote at "then returning to the
top-level blockquote" (cf. blockquote30.txt).
</p>

This is a test for

> a blockquote starting at top-level
> > then opening a nested level
> > further continuing at the nested level
> > > then opening a doubly-nested level
> > > further continuing at the doubly-nested level
> > then returning to the simply-nested level
> then returning to the top-level blockquote.

Here, all blank lines are omitted. markdown.pl
will open blockquotes as expected, but put
all text starting from "then opening a double-nested
level" until the end of the blockquote section into
the innermost blockquote level text, then close
all blockquotes.

<p>This is a test for
</p><blockquote><p>a blockquote starting at top-level
</p><blockquote><p>then opening a nested level
further continuing at the nested level
</p><blockquote><p>then opening a doubly-nested level
further continuing at the doubly-nested level
then returning to the simply-nested level
then returning to the top-level blockquote.
</p></blockquote></blockquote></blockquote><p>Here, all blank lines are omitted. markdown.pl
will open blockquotes as expected, but put
all text starting from "then opening a double-nested
level" until the end of the blockquote section into
the innermost blockquote level text, then close
all blockquotes.
</p>

This is a test for

> a blockquote starting at top-level
> > then opening a nested level
> > further continuing at the nested level
> > > then opening a doubly-nested level
> > > further continuing at the doubly-nested level
> >
> > then returning to the simply-nested level
>
> then returning to the top-level blockquote.

markdown.pl needs the blank lines as shown or wouldn't
return to the simply-nested (level 2) nesting level at
"then returning to the simply-nested level" nor to
the level 1 blockquote at "then returning to the
top-level blockquote" (cf. blockquote30.txt).

<p>This is a test for
</p><blockquote><p>a blockquote starting at top-level
</p><blockquote><p>then opening a nested level
further continuing at the nested level
</p><blockquote><p>then opening a doubly-nested level
further continuing at the doubly-nested level
</p></blockquote><p>then returning to the simply-nested level
</p></blockquote><p>then returning to the top-level blockquote.
</p></blockquote><p>markdown.pl needs the blank lines as shown or wouldn't
return to the simply-nested (level 2) nesting level at
"then returning to the simply-nested level" nor to
the level 1 blockquote at "then returning to the
top-level blockquote" (cf. blockquote30.txt).
</p>

> # This is a header #
> in a block quote.

Should render as expected.

<blockquote><h1 id="this-is-a-header">This is a header
</h1><p>in a block quote.
</p></blockquote><p>Should render as expected.
</p>

>  # This is a header #
>  in a block quote with two space chars between the blockquote char and text.

Should render as expected.

<blockquote><p> # This is a header #
 in a block quote with two space chars between the blockquote char and text.
</p></blockquote><p>Should render as expected.
</p>

The following blockquote contains a list.

> This is
>
> - said list
> - within a block quote.

<p>The following blockquote contains a list.
</p><blockquote><p>This is
</p><ul><li>said list
</li><li>within a block quote.
</li></ul></blockquote>

This

>     > tests nested
> block quotes

which use blockquoting chars with five spaces.
What looks like a nested blockquote will be rendered as a code block.

<p>This
</p><blockquote><pre><code>&#62; tests nested
</code></pre><p>block quotes
</p></blockquote><p>which use blockquoting chars with five spaces.
What looks like a nested blockquote will be rendered as a code block.
</p>

This

>	 > tests nested
> block quotes

which use blockquoting chars with a tab, followed by a single space char

<p>This
</p><blockquote><blockquote><p>tests nested
block quotes
</p></blockquote></blockquote><p>which use blockquoting chars with a tab, followed by a single space char
</p>

This

>   		> tests nested
> block quotes

which use blockquoting chars with three spaces followed by two tabs.
(cf blockquote10.txt)

<p>This
</p><blockquote><pre><code>	&#62; tests nested
</code></pre><p>block quotes
</p></blockquote><p>which use blockquoting chars with three spaces followed by two tabs.
(cf blockquote10.txt)
</p>

The following is a markup block demonstrating block quotes in markdown

		Block-quoted text following:

		> > Nested Block-quoted text
		>
		> Block-quoted text

<p>The following is a markup block demonstrating block quotes in markdown
</p><pre><code>	Block-quoted text following:

	&#62; &#62; Nested Block-quoted text
	&#62;
	&#62; Block-quoted text
</code></pre>