Markdown Node Types¶

Markdown document format node type mappings for AST semantic extraction

Document Structure¶

Top-level Markdown structure

Node Type	Semantic Type	Name Extraction	Description
`document`	DEFINITION_MODULE	NONE	Document - root Markdown container
`section`	ORGANIZATION_SECTION	CUSTOM	Section - logical document division
`paragraph`	LITERAL_STRING	NODE_TEXT	Paragraph - text block
`block_quote`	ORGANIZATION_BLOCK	NONE	Block quote - `> quoted text`

Headings¶

Markdown heading styles

Heading types: - ATX: # H1, ## H2, etc. (1-6 levels) - Setext: Underlined with === or ---

Node Type	Semantic Type	Name Extraction	Description
`atx_heading`	ORGANIZATION_SECTION	CUSTOM	ATX heading - `# Heading`
`setext_heading`	ORGANIZATION_SECTION	CUSTOM	Setext heading - underlined style
`heading_content`	NAME_IDENTIFIER	NODE_TEXT	Heading content - text of heading

Lists¶

Markdown list constructs

List types: - Unordered: -, *, + markers - Ordered: 1. or 1) markers - Nested via indentation

Node Type	Semantic Type	Name Extraction	Description
`list`	ORGANIZATION_LIST	NONE	Generic list container
`list_item`	ORGANIZATION_BLOCK	NONE	List item - single item in list
`ordered_list`	ORGANIZATION_LIST	NONE	Ordered list - `1.`, `2.`, etc.
`unordered_list`	ORGANIZATION_LIST	NONE	Unordered list - `-`, `*`, `+`
`list_marker`	PARSER_DELIMITER	NODE_TEXT	List marker - the bullet/number

Code Blocks¶

Markdown code constructs

Code types: - Fenced: ` with optional language - Indented: 4-space prefix - Inline: code ``

Node Type	Semantic Type	Name Extraction	Description
`code_fence`	ORGANIZATION_BLOCK	NONE	Code fence - ``` or ~~~
`fenced_code_block`	ORGANIZATION_BLOCK	CUSTOM	Fenced code block - ``` block
`indented_code_block`	ORGANIZATION_BLOCK	NONE	Indented code block - 4-space indented
`code_span`	LITERAL_STRING	NODE_TEXT	Code span - inline `code`
`info_string`	METADATA_ANNOTATION	NODE_TEXT	Info string - language after ```
`language`	METADATA_ANNOTATION	NODE_TEXT	Language - extracted language name

Links and References¶

Markdown link constructs

Link types: - Inline: [text](url "title") - Reference: [text][ref] - Definition: [ref]: url "title"

Node Type	Semantic Type	Name Extraction	Description
`link`	COMPUTATION_ACCESS	CUSTOM	Link - `[text](url)`
`image`	COMPUTATION_ACCESS	CUSTOM	Image - `![alt](url)`
`link_text`	NAME_IDENTIFIER	NODE_TEXT	Link text - display text
`link_title`	METADATA_ANNOTATION	NODE_TEXT	Link title - optional title
`link_destination`	LITERAL_STRING	NODE_TEXT	Link destination - URL/path
`link_reference_definition`	DEFINITION_VARIABLE	CUSTOM	Link reference definition - `[ref]: url`
`link_label`	NAME_IDENTIFIER	NODE_TEXT	Link label - reference identifier

Inline Elements¶

Markdown inline formatting

Inline styles: - Emphasis: *text* or _text_ - Strong: **text** or __text__ - Code: `code`

Node Type	Semantic Type	Name Extraction	Description
`emphasis`	METADATA_ANNOTATION	NODE_TEXT	Emphasis - `italic`
`strong_emphasis`	METADATA_ANNOTATION	NODE_TEXT	Strong emphasis - `bold`
`text`	LITERAL_STRING	NODE_TEXT	Text - plain text content
`hard_line_break`	PARSER_DELIMITER	NONE	Hard line break - trailing spaces or `\`
`soft_line_break`	PARSER_DELIMITER	NONE	Soft line break - single newline

Tables¶

GitHub Flavored Markdown tables

Table syntax: | Header | Header | |--------|--------| | Cell | Cell |

Node Type	Semantic Type	Name Extraction	Description
`table`	ORGANIZATION_CONTAINER	NONE	Table container
`table_header`	ORGANIZATION_SECTION	NONE	Table header row
`table_row`	ORGANIZATION_LIST	NONE	Table data row
`table_cell`	LITERAL_STRING	NODE_TEXT	Table cell content
`table_delimiter_row`	PARSER_DELIMITER	NONE	Table delimiter row - `\|---\|---\|`

HTML Content¶

Embedded HTML in Markdown

Node Type	Semantic Type	Name Extraction	Description
`html_block`	EXTERNAL_EMBED	NODE_TEXT	HTML block - standalone HTML
`html_inline`	EXTERNAL_EMBED	NODE_TEXT	HTML inline - inline HTML tags

Metadata¶

Document metadata and structure

Node Type	Semantic Type	Name Extraction	Description
`frontmatter`	METADATA_ANNOTATION	NODE_TEXT	Frontmatter - YAML/TOML metadata block
`thematic_break`	PARSER_DELIMITER	NONE	Thematic break - `---`, `***`, `___`

Punctuation and Delimiters¶

Markdown syntax tokens

Node Type	Semantic Type	Name Extraction	Description
`/`	PARSER_PUNCTUATION	NONE	Forward slash - `/`
`-`	PARSER_PUNCTUATION	NONE	Dash/minus - `-`
`_`	PARSER_PUNCTUATION	NONE	Underscore - `_`
`.`	PARSER_PUNCTUATION	NONE	Period - `.`
`*`	PARSER_PUNCTUATION	NONE	Asterisk - `*`
`,`	PARSER_PUNCTUATION	NONE	Comma - `,`
```	PARSER_DELIMITER	NONE	Backtick - `
`)`	PARSER_DELIMITER	NONE	Closing parenthesis - `)`
`(`	PARSER_DELIMITER	NONE	Opening parenthesis - `(`
`:`	PARSER_PUNCTUATION	NONE	Colon - `:`
`=`	PARSER_PUNCTUATION	NONE	Equals - `=`
`'`	PARSER_DELIMITER	NONE	Single quote - `'`
`[`	PARSER_DELIMITER	NONE	Opening bracket - `[`
`]`	PARSER_DELIMITER	NONE	Closing bracket - `]`
`;`	PARSER_PUNCTUATION	NONE	Semicolon - `;`
`#`	PARSER_PUNCTUATION	NONE	Hash - `#`
`+`	PARSER_PUNCTUATION	NONE	Plus - `+`
`>`	PARSER_PUNCTUATION	NONE	Greater than - `>`
`<`	PARSER_PUNCTUATION	NONE	Less than - `<`
`\|`	PARSER_DELIMITER	NONE	Pipe - `\|`
`!`	PARSER_PUNCTUATION	NONE	Exclamation - `!`

Markdown-Specific Constructs¶

Markdown structural elements

Node Type	Semantic Type	Name Extraction	Description
`block_continuation`	ORGANIZATION_BLOCK	NONE	Block continuation - continued block
`inline`	LITERAL_STRING	NODE_TEXT	Inline content - inline text run
`list_marker_minus`	PARSER_DELIMITER	NODE_TEXT	List marker minus - `-`
`fenced_code_block_delimiter`	PARSER_DELIMITER	NONE	Fenced code block delimiter - ``` or ~~~
`list_marker_plus`	PARSER_DELIMITER	NODE_TEXT	List marker plus - `+`
`list_marker_star`	PARSER_DELIMITER	NODE_TEXT	List marker star - `*`
`list_marker_dot`	PARSER_DELIMITER	NODE_TEXT	List marker dot - ordered list dot
`list_marker_parenthesis`	PARSER_DELIMITER	NODE_TEXT	List marker parenthesis - ordered list paren
`emphasis_delimiter`	PARSER_DELIMITER	NODE_TEXT	Emphasis delimiter - `*` or `_`
`strong_emphasis_delimiter`	PARSER_DELIMITER	NODE_TEXT	Strong emphasis delimiter - `**` or `__`
`code_fence_content`	LITERAL_STRING	NONE	Code fence content - code inside fence
`backslash_escape`	LITERAL_STRING	NONE	Backslash escape - `\*`
`entity_reference`	LITERAL_STRING	NODE_TEXT	Entity reference - ` `
`numeric_character_reference`	LITERAL_STRING	NODE_TEXT	Numeric character reference - ` `

Pipe Tables¶

GFM pipe table constructs

Node Type	Semantic Type	Name Extraction	Description
`pipe_table_header`	ORGANIZATION_SECTION	NONE	Pipe table header row
`pipe_table_row`	ORGANIZATION_LIST	NONE	Pipe table data row
`pipe_table_delimiter_row`	PARSER_DELIMITER	NONE	Pipe table delimiter row
`pipe_table_cell`	LITERAL_STRING	NODE_TEXT	Pipe table cell content

Task Lists¶

GitHub Flavored Markdown task lists

Task list syntax: - - [ ] unchecked - - [x] checked

Node Type	Semantic Type	Name Extraction	Description
`task_list_marker_checked`	PARSER_DELIMITER	NODE_TEXT	Task list marker checked - `[x]`
`task_list_marker_unchecked`	PARSER_DELIMITER	NODE_TEXT	Task list marker unchecked - `[ ]`

Strikethrough¶

GFM strikethrough syntax

Node Type	Semantic Type	Name Extraction	Description
`strikethrough`	METADATA_ANNOTATION	NODE_TEXT	Strikethrough - `~~text~~`
`strikethrough_delimiter`	PARSER_DELIMITER	NODE_TEXT	Strikethrough delimiter - `~~`

Autolinks¶

Automatic link detection

Node Type	Semantic Type	Name Extraction	Description
`uri_autolink`	COMPUTATION_ACCESS	NODE_TEXT	URI autolink - `<https://example.com>`
`email_autolink`	COMPUTATION_ACCESS	NODE_TEXT	Email autolink - `<email@example.com>`

Heading Markers¶

ATX and Setext heading markers

Node Type	Semantic Type	Name Extraction	Description
`atx_h3_marker`	ORGANIZATION_SECTION	NODE_TEXT	ATX H3 marker - `###`
`atx_h2_marker`	ORGANIZATION_SECTION	NODE_TEXT	ATX H2 marker - `##`
`{`	PARSER_DELIMITER	NONE	Opening brace - `{`
`}`	PARSER_DELIMITER	NONE	Closing brace - `}`
`&`	PARSER_PUNCTUATION	NONE	Ampersand - `&`
`%`	PARSER_PUNCTUATION	NONE	Percent - `%`
`$`	PARSER_PUNCTUATION	NONE	Dollar - `$`
`atx_h1_marker`	ORGANIZATION_SECTION	NODE_TEXT	ATX H1 marker - `#`
`?`	PARSER_PUNCTUATION	NONE	Question mark - `?`
`@`	PARSER_PUNCTUATION	NONE	At sign - `@`
`pipe_table_delimiter_cell`	PARSER_DELIMITER	NONE	Pipe table delimiter cell - `---`
`atx_h4_marker`	ORGANIZATION_SECTION	NODE_TEXT	ATX H4 marker - `####`
`\\`	PARSER_PUNCTUATION	NONE	Backslash - `\`
`~`	PARSER_PUNCTUATION	NONE	Tilde - `~`
`pipe_table`	ORGANIZATION_CONTAINER	NONE	Pipe table container
`^`	PARSER_PUNCTUATION	NONE	Caret - `^`
`pipe_table_align_left`	PARSER_DELIMITER	NONE	Pipe table align left - `:---`
`block_quote_marker`	PARSER_DELIMITER	NODE_TEXT	Block quote marker - `>`
`-->`	PARSER_DELIMITER	NONE	HTML comment end - `-->`
`pipe_table_align_right`	PARSER_DELIMITER	NONE	Pipe table align right - `---:`
`minus_metadata`	METADATA_ANNOTATION	NODE_TEXT	Minus metadata - frontmatter delimiter
`setext_h1_underline`	ORGANIZATION_SECTION	NODE_TEXT	Setext H1 underline - `===`
`atx_h5_marker`	ORGANIZATION_SECTION	NODE_TEXT	ATX H5 marker - `#####`

Parser Error Handling¶

Parser error nodes

Node Type	Semantic Type	Name Extraction	Description
`ERROR`	PARSER_SYNTAX	NODE_TEXT	Parse error node

Generated from markdown_types.def