@tanstack/markdown

TanStack Markdown

A tiny, fast, deterministic Markdown renderer for blogs and documentation.

The current browser bundles are 4.6 KB gzip for the parser, 6.4 KB for HTML rendering, and 6.3 KB for the React adapter. The package has no runtime dependencies and does not bundle syntax highlighting.

pnpm add @tanstack/markdown

import { renderHtml } from '@tanstack/markdown/html'

const html = renderHtml('# Fast by default')

import { Markdown } from '@tanstack/markdown/react'

export function Article({ source }: { source: string }) {
  return <Markdown>{source}</Markdown>
}

Raw HTML is escaped and executable link protocols are removed by default. allowHtml and highlighter output are explicit trusted-content boundaries.

Scope

This is deliberately not a complete CommonMark, GFM, MDX, or content-processing implementation. It implements the syntax used by technical blogs and documentation, then spends its complexity budget on deterministic output, safe defaults, React/HTML parity, malformed-input resilience, and small entry points.

See the docs Markdown profile for the supported contract and deliberate non-goals.

Verification

pnpm run verify

To include downstream repositories in the corpus gate:

MARKDOWN_CORPUS_DIRS=../tanstack.com/src/blog:../tanstack.com/docs pnpm run test:corpus

Reports

• Bundle sizes
• Benchmarks
• CommonMark compatibility accounting
• Audit
• Spec and API
• Extensions