title	Parser

Parser

The @tanstack/markdown/parser entry exports only the document parser and its transitive implementation.

import { parseMarkdown } from '@tanstack/markdown/parser'

`parseMarkdown`

function parseMarkdown(
  markdown: string,
  options?: ParseOptions,
): MarkdownDocument

Normalizes and parses a complete Markdown source string into a deterministic MarkdownDocument.

Option	Default	Behavior
`allowHtml`	`false`	Recognize raw block and inline HTML nodes
`urlTransform`	built-in policy	Override parsed link and image URLs; see Custom URL policy
`frontmatter`	`true`	Extract a leading `---` frontmatter block
`headingIds`	`true`	Generate IDs, disable them, or provide an ID function
`extensions`	`[]`	Run custom parser and transform hooks in array order
`references`	internal	Provide normalized reference definitions to nested parsing
`footnotes`	internal	Provide normalized footnote definitions to nested parsing
`footnoteOrder`	internal	Track first-reference order through nested parsing
`footnoteCounts`	internal	Track repeated references for back links

The last four state fields are public so extension-driven nested parsing can preserve parser context. Ordinary calls should leave them unset.

The result always has type: 'root' and a children array. It may also include raw frontmatter and extension-derived headings.

See Parsing for behavior and Types for complete contracts.