Base class for all AST nodes.

All nodes track their source location for error messages and debugging.

Plain text content.

The most common inline node, representing literal text.

Emphasized (italic) text.

Markdown: text or text HTML: text

Strong (bold) text.

Markdown: text or text HTML: text

Hyperlink.

Markdown: text or [text][ref] HTML: text

Image.

Markdown: HTML:

Inline code.

Markdown:code HTML:code

Hard line break.

Markdown:\at end of line or two trailing spaces HTML:

Soft line break (single newline in paragraph).

Typically rendered as a space or newline depending on renderer settings.

Inline raw HTML.

Markdown: text HTML: passed through unchanged

Inline role (MyST syntax).

Markdown: content Example: target, Ctrl+C

Strikethrough (deleted) text.

Markdown: deleted HTML: deleted

Inline math expression.

Markdown: $E = mc^2$ HTML: E = mc^2

Footnote reference.

Markdown: [^1] or [^note] HTML: ¹

ATX or setext heading.

Markdown: # Heading or Heading

====== HTML:

Heading

Supports MyST-compatible explicit anchor syntax: ## Title {#custom-id}
The {#id} is parsed during lexing and stored in explicit_id.

Paragraph block.

Markdown: Text separated by blank lines HTML:

text

Fenced code block with zero-copy source reference.

BREAKING CHANGE (v0.4.0): Previous: code: str (extracted content) Current: source_start/source_end indices into original source

Migration:

Old: block.code
New: block.get_code(source)

For nested contexts (e.g., fenced code inside block quotes), the content_override field stores the actual code content directly since the source offsets would be relative to a sub-parser's source.

Indented code block (4+ spaces).

Markdown: ····code HTML:

code

Block quote.

Markdown: > quoted text HTML:

text

List item.

Markdown: - item or 1. item HTML:

Ordered or unordered list.

Markdown: - item or 1. item HTML:

/
with
1. children

Thematic break (horizontal rule).

Markdown: --- or *** or ___ HTML:

Raw HTML block.

Markdown: HTML that starts a block HTML: passed through unchanged

Block directive (MyST syntax).

Markdown: :::{name} title

:option: value content :::

Generic over options type for full type safety. Use Directive[YourOptions]
to get typed options access in handlers.

PEP 695 Note:
    Uses Python 3.12+ type parameter syntax: `class Directive[TOptions: DirectiveOptions]`
    instead of the older `class Directive(Node, Generic[TOptions])` with TypeVar.

Root document node.

Contains all top-level blocks in the document.

Table cell (th or td).

Markdown: | cell content | HTML: cell content or cell content

Table row.

Markdown: | cell1 | cell2 | HTML: cell1cell2

Table (GFM-style).

Markdown:

| A | B |
|---|---|
| 1 | 2 |

HTML:

Block math expression.

Markdown:

$$
E = mc^2
$$

HTML:

Footnote definition.

Markdown: [^1]: Footnote content here. HTML: (rendered in footnotes section)