` within a HTML block started by `
foo→baz→→bim
foo→baz→→bim
a→a
ὐ→a
foo
bar
foo
bar
```````````````````````````````` ```````````````````````````````` example -→→foo .foo
foo
foo
bar
+++
```````````````````````````````` ```````````````````````````````` example === .===
```````````````````````````````` Not enough characters: ```````````````````````````````` example -- ** __ .-- ** __
```````````````````````````````` One to three spaces indent are allowed: ```````````````````````````````` example *** *** *** .***
Foo ***
```````````````````````````````` More than three characters may be used: ```````````````````````````````` example _____________________________________ ._ _ _ _ a
a------
---a---
```````````````````````````````` It is required that all of the [non-whitespace characters] be the same. So, this is not a thematic break: ```````````````````````````````` example *-* .-
```````````````````````````````` Thematic breaks do not need blank lines before or after: ```````````````````````````````` example - foo *** - bar .Foo
bar
```````````````````````````````` If a line of dashes that meets the above conditions for being a thematic break could also be interpreted as the underline of a [setext heading], the interpretation as a [setext heading] takes precedence. Thus, for example, this is a setext heading, not a paragraph followed by a thematic break: ```````````````````````````````` example Foo --- bar .bar
```````````````````````````````` When both a thematic break and a list item are possible interpretations of a line, the thematic break takes precedence: ```````````````````````````````` example * Foo * * * * Bar .####### foo
```````````````````````````````` At least one space is required between the `#` characters and the heading's contents, unless the heading is empty. Note that many implementations currently do not require the space. However, the space was required by the [original ATX implementation](http://www.aaronsw.com/2002/atx/atx.py), and it helps prevent things like the following from being parsed as headings: ```````````````````````````````` example #5 bolt #hashtag .#5 bolt
#hashtag
```````````````````````````````` This is not a heading, because the first `#` is escaped: ```````````````````````````````` example \## foo .## foo
```````````````````````````````` Contents are parsed as inlines: ```````````````````````````````` example # foo *bar* \*baz\* .# foo
foo # bar
```````````````````````````````` A closing sequence of `#` characters is optional: ```````````````````````````````` example ## foo ## ### bar ### .Foo bar
Bar foo
```````````````````````````````` ATX headings can be empty: ```````````````````````````````` example ## # ### ### . ```````````````````````````````` ## Setext headings A [setext heading](@) consists of one or more lines of text, each containing at least one [non-whitespace character], with no more than 3 spaces indentation, followed by a [setext heading underline]. The lines of text must be such that, were they not followed by the setext heading underline, they would be interpreted as a paragraph: they cannot be interpretable as a [code fence], [ATX heading][ATX headings], [block quote][block quotes], [thematic break][thematic breaks], [list item][list items], or [HTML block][HTML blocks]. A [setext heading underline](@) is a sequence of `=` characters or a sequence of `-` characters, with no more than 3 spaces indentation and any number of trailing spaces. If a line containing a single `-` can be interpreted as an empty [list items], it should be interpreted this way and not as a [setext heading underline]. The heading is a level 1 heading if `=` characters are used in the [setext heading underline], and a level 2 heading if `-` characters are used. The contents of the heading are the result of parsing the preceding lines of text as CommonMark inline content. In general, a setext heading need not be preceded or followed by a blank line. However, it cannot interrupt a paragraph, so when a setext heading comes after a paragraph, a blank line is needed between them. Simple examples: ```````````````````````````````` example Foo *bar* ========= Foo *bar* --------- .Foo
---
Foo
Foo ---
```````````````````````````````` The setext heading underline cannot contain internal spaces: ```````````````````````````````` example Foo = = Foo --- - .Foo = =
Foo
`
of dashes"/>
```````````````````````````````` The setext heading underline cannot be a [lazy continuation line] in a list item or block quote: ```````````````````````````````` example > Foo --- .Foo
```````````````````````````````` ```````````````````````````````` example - Foo --- .foo bar ===
Baz
```````````````````````````````` Setext headings cannot be empty: ```````````````````````````````` example ==== .====
```````````````````````````````` Setext heading text lines must not be interpretable as block constructs other than paragraphs. So, the line of dashes in these examples gets interpreted as a thematic break: ```````````````````````````````` example --- --- .foo
foo
Foo
baz
```````````````````````````````` Authors who want interpretation 2 can put blank lines around the thematic break, ```````````````````````````````` example Foo bar --- baz .Foo bar
baz
```````````````````````````````` or use a thematic break that cannot count as a [setext heading underline], such as ```````````````````````````````` example Foo bar * * * baz .Foo bar
baz
```````````````````````````````` Authors who want interpretation 3 can use backslash escapes: ```````````````````````````````` example Foo bar \--- baz .Foo bar --- baz
```````````````````````````````` ## Indented code blocks An [indented code block](@) is composed of one or more [indented chunks] separated by blank lines. An [indented chunk](@) is a sequence of non-blank lines, each indented four or more spaces. The contents of the code block are the literal contents of the lines, including trailing [line endings], minus four spaces of indentation. An indented code block has no [info string]. An indented code block cannot interrupt a paragraph, so there must be a blank line between a paragraph and a following indented code block. (A blank line is not needed, however, between a code block and a following paragraph.) ```````````````````````````````` example a simple indented code block .a simple
indented code block
foo
bar
foo
<a/>
*hi*
- one
chunk1
chunk2
chunk3
chunk1
chunk2
Foo bar
```````````````````````````````` However, any non-blank line with fewer than four leading spaces ends the code block immediately. So a paragraph may occur immediately after indented code: ```````````````````````````````` example foo bar .foo
bar
```````````````````````````````` And indented code can occur immediately before and after other kinds of blocks: ```````````````````````````````` example # Heading foo Heading ------ foo ---- .foo
foo
foo
bar
foo
foo
<
>
<
>
foo
aaa
~~~
aaa
```
aaa
```
aaa
~~~
```
aaa
aaa
bbb
```````````````````````````````` A code block can have all empty lines as its content: ```````````````````````````````` example ``` ``` .
aaa
aaa
aaa
aaa
aaa
aaa
aaa
aaa
```
aaa
```
aaa
aaa
aaa
```
aaa
aaa
~~~ ~~
foo
bar
baz
```````````````````````````````` Other blocks can also occur before and after fenced code blocks without an intervening blank line: ```````````````````````````````` example foo --- ~~~ bar ~~~ # baz .bar
def foo(x)
return 3
end
def foo(x)
return 3
end
aa
foo
foo
``` aaa
` within a HTML block started by `
