Headings, Rules and Blockquotes

This page covers headings, horizontal rules, blockquotes and GitHub-style alert boxes.

Headings

Source	Output
`# Text` to `###### Text`	`<h1>` to `<h6>`
`Text` with `===` (3 or more) on the next line	`<h1>`
`Text` with `---` (3 or more) on the next line	`<h2>`
Inside a table cell `\| ## Text \|`	`<h2>` inside the cell

Rule	Detail
Space after `#` required	`#tag` is not a heading and may become a Hashtag Link
Allowed lead-ins	A `#` after leading spaces, `>` , or a list marker (`-` , `1.` ) also becomes a heading
Escape	`\# Text` is not converted
No ids	Headings get no `id` attribute, so they cannot be linked by anchor

Horizontal Rules

A line containing only --- or *** (3 or more, surrounding spaces allowed) outputs <hr>.

Source	Result
`---`, `*****`	`<hr>`
`* * *`, `- - -`	Not supported; read as a list
`___`	Not supported
`---` under a line of text	setext `<h2>`, not a rule

Blockquotes

> Level one
>> Level two
> - A list inside the quote

Rule	Detail
Start	Every line begins with `>`; consecutive lines merge into one `<blockquote>`
Nesting	`>>` creates an inner `<blockquote>`; later `>` lines in the same block stay in the inner level instead of returning to the outer one
Content	Each line is wrapped in a `<span>`; lines go through list conversion first, so lists work

Alerts

Extended mode supports GitHub-style alerts; the marker must be the first line of the quote:

> [!WARNING]
> This action cannot be undone

Marker	Icon (Material Symbols)
`[!NOTE]`	`info`
`[!TIP]`	`lightbulb`
`[!IMPORTANT]`	`sms`
`[!WARNING]`	`warning`
`[!CAUTION]`	`error`

The output is <blockquote class="WARNING"> with the first line replaced by a <span class="hint"> holding the icon and type name. Markers must be uppercase; standard mode outputs the literal [!WARNING] text.