Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -89,8 +89,8 @@
"@tanstack/ai-openrouter": "^0.19.9",
"@tanstack/charts": "1.0.0",
"@tanstack/create": "^0.70.1",
"@tanstack/highlight": "^0.0.9",
"@tanstack/markdown": "^0.0.16",
"@tanstack/highlight": "^1.0.0",
"@tanstack/markdown": "^1.0.0",
"@tanstack/pacer": "^0.21.1",
"@tanstack/react-db": "0.4.1",
"@tanstack/react-hotkeys": "^0.10.0",
Expand Down
20 changes: 10 additions & 10 deletions pnpm-lock.yaml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

6 changes: 3 additions & 3 deletions src/blog/introducing-tanstack-markdown-and-highlight.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ RSC gave us a good way to keep that system on the server, and it worked, but the

So we made the expensive part small.

Today we're releasing the first alphas of [TanStack Markdown](/markdown) and [TanStack Highlight](/highlight), two deliberately narrow libraries built around the content contract we actually need for technical blogs, documentation, and streamed AI output. The last post was about the architecture we could remove, this one is about what we built to remove it.
Today we're releasing the first releases of [TanStack Markdown](/markdown) and [TanStack Highlight](/highlight), two deliberately narrow libraries built around the content contract we actually need for technical blogs, documentation, and streamed AI output. The last post was about the architecture we could remove, this one is about what we built to remove it.

## Parsing and highlighting are different jobs

Expand Down Expand Up @@ -136,7 +136,7 @@ Coding agents made it practical for us to explore purpose-built parsers and scan

TanStack Highlight's committed corpus currently samples **333 fixtures from 2,940 TanStack documentation files**. Release checks cover token fidelity, deterministic HTML, package exports, bundle profiles, focused parser regressions, and a roughly 10,000-block throughput budget. Markdown tracks its supported CommonMark examples explicitly, checks renderer parity, and audits real TanStack and external content corpora.

The first tanstack.com migrations found edge cases in tight lists and image handling almost immediately. That's exactly what alpha software should surface, and every fix has to leave behind a focused regression test instead of another clever branch nobody can explain six months later.
The first tanstack.com migrations found edge cases in tight lists and image handling almost immediately. That's exactly what an early release should surface, and every fix has to leave behind a focused regression test instead of another clever branch nobody can explain six months later.

The cost of going tiny is owning the contract. We want that cost in the repositories where everyone can inspect it.

Expand All @@ -148,7 +148,7 @@ Our RSC content pipeline existed largely to keep the old Markdown and highlighti

The [RSC post](/blog/we-removed-rsc-from-tanstack-com) has the measurements and caveats behind that decision. For this announcement, the important part is that these aren't tiny libraries built around a benchmark toy, they're already carrying the messiest content corpus we own.

## Alpha means the contract can still move
## Try them on your own content

Both libraries are available now:

Expand Down
2 changes: 0 additions & 2 deletions src/libraries/libraries.ts
Original file line number Diff line number Diff line change
Expand Up @@ -627,7 +627,6 @@ export const markdown: LibrarySlim = {
tagline: 'A serializable document model for docs and AI streams',
description:
'A deliberately bounded Markdown parser with a public serializable AST, safe defaults, deterministic React, HTML, and Octane output, and a stateless profile for accumulated AI streams.',
badge: 'alpha',
bgStyle: 'bg-fuchsia-500',
borderStyle: 'border-fuchsia-500/50',
textStyle: 'text-fuchsia-500 dark:text-fuchsia-400',
Expand Down Expand Up @@ -658,7 +657,6 @@ export const highlight: LibrarySlim = {
tagline: 'Web-first syntax highlighting with compact, themeable HTML',
description:
'A synchronous syntax highlighter with selective language imports, context-aware web scanners, semantic CSS themes, precise annotations, and compact deterministic output.',
badge: 'alpha',
bgStyle: 'bg-amber-500',
borderStyle: 'border-amber-500/50',
textStyle: 'text-amber-500 dark:text-amber-400',
Expand Down
10 changes: 5 additions & 5 deletions src/utils/builder-environment.ts
Original file line number Diff line number Diff line change
Expand Up @@ -19,12 +19,12 @@ export const builderImports = {
'https://esm.sh/@tanstack/charts@0.16.1/octane/core?external=octane',
'@tanstack/charts-data/':
'https://esm.sh/gh/TanStack/charts@b8690671d677244848cff0eebd3d5dd0d5825b18/packages/charts-demo-data/src/',
'@tanstack/highlight': 'https://esm.sh/@tanstack/highlight@0.0.10',
'@tanstack/highlight/': 'https://esm.sh/@tanstack/highlight@0.0.10/',
'@tanstack/markdown': 'https://esm.sh/@tanstack/markdown@0.0.13',
'@tanstack/highlight': 'https://esm.sh/@tanstack/highlight@1.0.0',
'@tanstack/highlight/': 'https://esm.sh/@tanstack/highlight@1.0.0/',
'@tanstack/markdown': 'https://esm.sh/@tanstack/markdown@1.0.0',
'@tanstack/markdown/react':
'https://esm.sh/@tanstack/markdown@0.0.13/react?external=react',
'@tanstack/markdown/': 'https://esm.sh/@tanstack/markdown@0.0.13/',
'https://esm.sh/@tanstack/markdown@1.0.0/react?external=react',
'@tanstack/markdown/': 'https://esm.sh/@tanstack/markdown@1.0.0/',
'@tanstack/pacer': 'https://esm.sh/@tanstack/pacer@0.21.1',
'@tanstack/react-pacer':
'https://esm.sh/@tanstack/react-pacer@0.22.1?external=react',
Expand Down
10 changes: 5 additions & 5 deletions tests/builder-environment.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -128,23 +128,23 @@ test('provides hidden entry modules for every example environment', () => {
test('exposes current Highlight and Markdown modules', () => {
assert.equal(
builderImports['@tanstack/highlight'],
'https://esm.sh/@tanstack/highlight@0.0.10',
'https://esm.sh/@tanstack/highlight@1.0.0',
)
assert.equal(
builderImports['@tanstack/highlight/'],
'https://esm.sh/@tanstack/highlight@0.0.10/',
'https://esm.sh/@tanstack/highlight@1.0.0/',
)
assert.equal(
builderImports['@tanstack/markdown'],
'https://esm.sh/@tanstack/markdown@0.0.13',
'https://esm.sh/@tanstack/markdown@1.0.0',
)
assert.equal(
builderImports['@tanstack/markdown/'],
'https://esm.sh/@tanstack/markdown@0.0.13/',
'https://esm.sh/@tanstack/markdown@1.0.0/',
)
assert.equal(
builderImports['@tanstack/markdown/react'],
'https://esm.sh/@tanstack/markdown@0.0.13/react?external=react',
'https://esm.sh/@tanstack/markdown@1.0.0/react?external=react',
)

const guide = generateBuilderLlmsTxt()
Expand Down
9 changes: 5 additions & 4 deletions tests/markdown-highlight-versions.test.ts
Original file line number Diff line number Diff line change
@@ -1,10 +1,11 @@
import assert from 'node:assert/strict'
import test from 'node:test'
import { getBranch, highlight, markdown } from '../src/libraries'
import { charts, getBranch, highlight, markdown } from '../src/libraries'
import { validateLibraryVersion } from '../src/routes/-library-landing'

for (const library of [markdown, highlight]) {
for (const library of [markdown, highlight, charts]) {
test(`${library.id} v1 picker uses the current docs branch and retires v0`, () => {
assert.equal(library.badge, undefined)
assert.equal(library.latestVersion, 'v1')
assert.deepEqual(library.availableVersions, ['v1'])
assert.equal(getBranch(library, 'v1'), 'main')
Expand All @@ -29,13 +30,13 @@ for (const library of [markdown, highlight]) {
const baseUrl = process.env.TANSTACK_DOCS_SMOKE_BASE_URL

test(
'Markdown and Highlight v0 and v1 docs aliases preserve paths and query strings',
'Markdown, Highlight, and Charts v0 and v1 docs aliases preserve paths and query strings',
{
skip: baseUrl ? false : 'Set TANSTACK_DOCS_SMOKE_BASE_URL for route checks',
},
async () => {
assert.ok(baseUrl)
for (const library of [markdown, highlight]) {
for (const library of [markdown, highlight, charts]) {
for (const version of ['v0', 'v1']) {
const response: Response = await fetch(
new URL(
Expand Down
Loading