yagggi / markdown.py Goto Github PK

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.

• Leaf blocks
  • #10 Thematic breaks
  • #11 ATX headings
  • #5 Setext headings
  • #12 Indented code blocks
  • #13 Fenced code blocks
  • #14 HTML blocks
    • <script> </script>
    • <!-- -->
    • <? ?>
    • <! >
    • <![CDATA[ ]]>
    • <table> </table>
    • <other> </other>
  • #15 Link reference definitions
  • #3 Paragraphs
• #4 Container blocks
  • #6 Block quotes
  • #7 List items
    • #8 Bullet lists
    • #9 Ordered lists
  • #4 Lists

A line consisting of 0-3 spaces of indentation, followed by a sequence of three or more matching -, _, or * characters, each followed optionally by any number of spaces, forms a thematic break.

A bullet list marker is a -, +, or * character.

A code fence is a sequence of at least three consecutive backtick characters (`) or tildes (~). (Tildes and backticks cannot be mixed.) A fenced code block begins with a code fence, indented no more than three spaces.

An HTML block is a group of lines that is treated as raw HTML (and will not be escaped in HTML output).

An ordered list marker is a sequence of 1–9 arabic digits (0-9), followed by either a . character or a ) character. (The reason for the length limit is that with 10 digits we start seeing integer overflows in some browsers.)

https://coveralls.io/

A block quote marker consists of 0-3 spaces of initial indent, plus (a) the character > together with a following space, or (b) a single character > not followed by a space.

A link reference definition consists of a link label, indented up to three spaces, followed by a colon (:), optional whitespace (including up to one line ending), a link destination, optional whitespace (including up to one line ending), and an optional link title, which if it is present must be separated from the link destination by whitespace. No further non-whitespace characters may occur on the line.

A sequence of non-blank lines that cannot be interpreted as other kinds of blocks forms a paragraph. The contents of the paragraph are the result of parsing the paragraph’s raw content as inlines. The paragraph’s raw content is formed by concatenating the lines and removing initial and final whitespace.

Interrupt continuation:
Thematic breaks
ATX headings
Fenced code block
HTML blocks 1-6
Block quotes
List (non-empty)

A list marker is a bullet list marker or an ordered list marker.

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 ATX heading consists of a string of characters, parsed as inline content, between an opening sequence of 1–6 unescaped # characters and an optional closing sequence of any number of unescaped # characters. The opening sequence of # characters must be followed by a space or by the end of line. The optional closing sequence of #s must be preceded by a space and may be followed by spaces only. The opening # character may be indented 0-3 spaces. The raw contents of the heading are stripped of leading and trailing spaces before being parsed as inline content. The heading level is equal to the number of # characters in the opening sequence.

A list is a sequence of one or more list items of the same type. The list items may be separated by any number of blank lines.