From 06871e8edf5a71d325d4270d25fa32a8da092f65 Mon Sep 17 00:00:00 2001
From: Tanner Linsley <tannerlinsley@gmail.com>
Date: Fri, 11 Sep 2026 13:55:55 -0600
Subject: [PATCH] Refresh Markdown landing page for v0.0.14

---
 package.json                               |  2 +-
 pnpm-lock.yaml                             | 10 ++--
 src/components/landing/LibraryLanding.tsx  | 10 ++--
 src/components/landing/MarkdownLanding.tsx | 59 ++++++++--------------
 4 files changed, 33 insertions(+), 48 deletions(-)

diff --git a/package.json b/package.json
index b90910949..fe8edd200 100644
--- a/package.json
+++ b/package.json
@@ -79,7 +79,7 @@
     "@tanstack/charts": "0.16.1",
     "@tanstack/create": "^0.70.0",
     "@tanstack/highlight": "^0.0.9",
-    "@tanstack/markdown": "^0.0.11",
+    "@tanstack/markdown": "^0.0.14",
     "@tanstack/pacer": "^0.21.1",
     "@tanstack/react-db": "0.3.1",
     "@tanstack/react-hotkeys": "^0.10.0",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 05725556b..ceb12bc47 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -121,8 +121,8 @@ importers:
         specifier: ^0.0.9
         version: 0.0.9
       '@tanstack/markdown':
-        specifier: ^0.0.11
-        version: 0.0.11(octane@0.1.13(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(vite@8.0.16(@types/node@25.5.0)(esbuild@0.27.4)(jiti@2.7.0)(tsx@4.21.0)(yaml@2.9.0)))(react@19.2.3)
+        specifier: ^0.0.14
+        version: 0.0.14(octane@0.1.13(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(vite@8.0.16(@types/node@25.5.0)(esbuild@0.27.4)(jiti@2.7.0)(tsx@4.21.0)(yaml@2.9.0)))(react@19.2.3)
       '@tanstack/pacer':
         specifier: ^0.21.1
         version: 0.21.1
@@ -3475,8 +3475,8 @@ packages:
     resolution: {integrity: sha512-vqH7X9nb0MTJ/O08++dB5bP9jgj4+BIPOUu/U+6myG86lDsirZSVSobpq5UQpE7nBuk62i8eIYeOhd+OMl/UrA==}
     engines: {node: '>=18'}
 
-  '@tanstack/markdown@0.0.11':
-    resolution: {integrity: sha512-Awu1PXI8VQ3limqRFe2GRFVnYAKzhEE9h/D5g6iTQYSpZVDn1kZ/1W40EFP3HWy8hVuop0fAlIhB+aEhrerpGw==}
+  '@tanstack/markdown@0.0.14':
+    resolution: {integrity: sha512-NNjOoA7Zbmh3LG6MTxTBX3zM8sGe5bMfH3xxX5oCt1zh75TiCiaQFoQ4FKSNNhVKqpD0zzNd+qNdmA+sXR5XTw==}
     peerDependencies:
       octane: '>=0.1.12'
       react: '>=18'
@@ -9693,7 +9693,7 @@ snapshots:
     dependencies:
       '@tanstack/store': 0.11.0
 
-  '@tanstack/markdown@0.0.11(octane@0.1.13(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(vite@8.0.16(@types/node@25.5.0)(esbuild@0.27.4)(jiti@2.7.0)(tsx@4.21.0)(yaml@2.9.0)))(react@19.2.3)':
+  '@tanstack/markdown@0.0.14(octane@0.1.13(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(vite@8.0.16(@types/node@25.5.0)(esbuild@0.27.4)(jiti@2.7.0)(tsx@4.21.0)(yaml@2.9.0)))(react@19.2.3)':
     optionalDependencies:
       octane: 0.1.13(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(vite@8.0.16(@types/node@25.5.0)(esbuild@0.27.4)(jiti@2.7.0)(tsx@4.21.0)(yaml@2.9.0))
       react: 19.2.3
diff --git a/src/components/landing/LibraryLanding.tsx b/src/components/landing/LibraryLanding.tsx
index 896f9c39a..f0663ddc8 100644
--- a/src/components/landing/LibraryLanding.tsx
+++ b/src/components/landing/LibraryLanding.tsx
@@ -371,14 +371,18 @@ export function LandingSectionIntro({
   action?: React.ReactNode
   body: React.ReactNode
   centered?: boolean
-  eyebrow: string
+  eyebrow?: string
   icon?: React.ReactNode
   title: string
 }) {
   return (
     <div className={centered ? 'mx-auto max-w-208 text-center' : 'max-w-168'}>
-      <LandingEyebrow icon={icon}>{eyebrow}</LandingEyebrow>
-      <h2 className="mt-6 text-ds-heading-1 md:text-ds-display-sm">{title}</h2>
+      {eyebrow ? <LandingEyebrow icon={icon}>{eyebrow}</LandingEyebrow> : null}
+      <h2
+        className={`text-ds-heading-1 md:text-ds-display-sm ${eyebrow ? 'mt-6' : ''}`}
+      >
+        {title}
+      </h2>
       <p className="mt-6 text-ds-body-sm text-text-primary/55 sm:text-ds-body-md">
         {body}
       </p>
diff --git a/src/components/landing/MarkdownLanding.tsx b/src/components/landing/MarkdownLanding.tsx
index 3fece9b9a..d9c777102 100644
--- a/src/components/landing/MarkdownLanding.tsx
+++ b/src/components/landing/MarkdownLanding.tsx
@@ -6,17 +6,11 @@ import { Markdown } from '@tanstack/markdown/react'
 import { streamingMarkdownExtension } from '@tanstack/markdown/extensions/streaming'
 import {
   ArrowRightIcon,
-  BracketsCurlyIcon,
   CheckIcon,
-  FileTextIcon,
-  HighlighterIcon,
   LockKeyIcon,
-  PackageIcon,
   PauseIcon,
   PlayIcon,
-  RadioIcon,
   ArrowCounterClockwiseIcon,
-  ShieldCheckIcon,
   XIcon,
 } from '@phosphor-icons/react'
 
@@ -138,9 +132,9 @@ const streamingExtensions = [streamingMarkdownExtension()]
 
 const bundleComparisons = [
   {
-    name: 'TanStack parser',
-    size: '4.9 KB',
-    width: 'w-[9%]',
+    name: 'TanStack HTML',
+    size: '6.7 KB',
+    width: 'w-[13%]',
     emphasis: true,
   },
   { name: 'marked', size: '12.5 KB', width: 'w-[24%]', emphasis: false },
@@ -171,8 +165,6 @@ export default function MarkdownLanding() {
       <LandingSection tone="accent">
         <LandingSectionIntro
           centered
-          eyebrow="The durable layer"
-          icon={<BracketsCurlyIcon aria-hidden="true" size={15} />}
           title="The AST is the product."
           body="Parsing does not trap content inside a renderer. Edit the source and inspect the serializable tree, deterministic HTML, or React output."
         />
@@ -182,8 +174,6 @@ export default function MarkdownLanding() {
       <LandingSection tone="ink">
         <div className="grid items-center gap-12 lg:grid-cols-[0.72fr_1.28fr] lg:gap-16">
           <LandingSectionIntro
-            eyebrow="Accumulated AI responses"
-            icon={<RadioIcon aria-hidden="true" size={15} />}
             title="Stream the text. Keep the parser stateless."
             body="Append each chunk and pass the complete string through Markdown. The optional streaming profile reparses synchronously, with no incremental state to coordinate or recover."
           />
@@ -194,8 +184,6 @@ export default function MarkdownLanding() {
       <LandingSection tone="raised">
         <div className="grid items-center gap-12 lg:grid-cols-[0.72fr_1.28fr] lg:gap-16">
           <LandingSectionIntro
-            eyebrow="A deliberate profile"
-            icon={<FileTextIcon aria-hidden="true" size={15} />}
             title="It does less Markdown on purpose."
             body="Technical docs need a known vocabulary, not an open-ended compiler platform. New syntax has to justify its bytes, ambiguity, and maintenance cost."
           />
@@ -214,10 +202,8 @@ export default function MarkdownLanding() {
         </div>
         <div className="mt-12 grid items-center gap-12 border-t border-border-subtle pt-12 lg:grid-cols-[0.72fr_1.28fr] lg:gap-16">
           <LandingSectionIntro
-            eyebrow="Boundary behavior"
-            icon={<ShieldCheckIcon aria-hidden="true" size={15} />}
-            title="Unsafe surprises are opt-in."
-            body="Raw HTML starts escaped, executable URL schemes are stripped, and text, attributes, and code are encoded at render time."
+            title="Safe defaults for Markdown input."
+            body="Markdown source renders with raw HTML escaped and unsafe link and image URLs removed by default. Custom ASTs, highlighters, and HTML hooks are trusted application inputs."
           />
           <SafetyProof />
         </div>
@@ -226,8 +212,6 @@ export default function MarkdownLanding() {
       <LandingSection tone="accent">
         <div className="grid items-center gap-12 lg:grid-cols-[0.72fr_1.28fr] lg:gap-16">
           <LandingSectionIntro
-            eyebrow="Size ledger"
-            icon={<PackageIcon aria-hidden="true" size={15} />}
             title="A parser should not outweigh the page."
             body="Split entry points keep the parser, renderers, framework adapters, and docs extensions independent. Import only the layer the page needs."
           />
@@ -238,10 +222,8 @@ export default function MarkdownLanding() {
       <LandingSection tone="ink">
         <div className="grid items-center gap-12 lg:grid-cols-[1.08fr_0.92fr] lg:gap-16">
           <LandingSectionIntro
-            eyebrow="Content, then color"
-            icon={<HighlighterIcon aria-hidden="true" size={15} />}
             title="Syntax highlighting stays outside the parser."
-            body="Code fences carry language and metadata. An explicit highlighter renders them later, so the core never silently imports a grammar engine."
+            body="Code fences store language and metadata in the AST. Supply a highlighter callback to render escaped token markup inside Markdown's code containers."
           />
           <Link
             to="/highlight/$version"
@@ -285,7 +267,6 @@ function ManuscriptPanel() {
     <div className="library-landing-graphic min-w-0 overflow-hidden rounded-xl border border-[color:rgb(var(--landing-glow)/0.45)] bg-background-surface shadow-[0_24px_70px_-28px_rgb(var(--landing-glow)/0.45)]">
       <div className="flex items-center justify-between border-b border-border-subtle px-4 py-3 font-ds-mono text-ds-mono-caps-xs uppercase text-text-primary/55">
         <span>article.md</span>
-        <span>{document.children.length} blocks / live</span>
       </div>
       <div className="grid md:grid-cols-[0.9fr_1.1fr]">
         <pre className="max-h-[24rem] overflow-auto border-b border-border-subtle p-5 font-ds-mono text-ds-mono-xs leading-7 !text-text-secondary md:border-b-0 md:border-r [&_code]:!text-inherit">
@@ -383,7 +364,6 @@ function MarkdownWorkbench() {
     [document],
   )
   const html = React.useMemo(() => renderDocument(document), [document])
-  const nodeCount = (ast.match(/"type":/g) ?? []).length
 
   return (
     <div className="mt-10 overflow-hidden rounded-xl border border-border-subtle bg-background-surface">
@@ -434,9 +414,6 @@ function MarkdownWorkbench() {
 
         <div className="flex h-[28rem] min-w-0 flex-col lg:h-[34rem]">
           <div className="flex flex-col justify-between gap-2 border-b border-border-subtle px-4 py-2 sm:flex-row sm:items-center">
-            <span className="font-ds-mono text-ds-mono-caps-xs uppercase text-text-primary/55">
-              One document, three views
-            </span>
             <div
               className="flex rounded-md bg-text-primary/5 p-1"
               role="tablist"
@@ -482,12 +459,6 @@ function MarkdownWorkbench() {
           </div>
         </div>
       </div>
-
-      <div className="flex flex-col justify-between gap-2 border-t border-border-subtle px-4 py-3 font-ds-mono text-ds-mono-caps-xs uppercase text-text-primary/45 sm:flex-row">
-        <span>{nodeCount} typed nodes</span>
-        <span>{source.length} source characters</span>
-        <span>JSON serializable</span>
-      </div>
     </div>
   )
 }
@@ -725,10 +696,10 @@ function BundleLedger() {
       ))}
       <div className="grid grid-cols-2 gap-px overflow-hidden rounded-xl bg-border-subtle p-px font-ds-mono text-ds-mono-xs sm:grid-cols-4">
         {[
-          ['6.7 KB', 'HTML renderer'],
-          ['6.7 KB', 'React adapter'],
-          ['6.7 KB', 'Octane adapter'],
-          ['2.4 KB', 'docs preset'],
+          ['4.9 KB', 'Parser'],
+          ['6.6 KB', 'React adapter'],
+          ['6.6 KB', 'Octane adapter'],
+          ['2.3 KB', 'docs preset'],
         ].map(([value, label]) => (
           <div key={label} className="bg-background-surface px-3 py-4">
             <div className="font-black">{value}</div>
@@ -738,6 +709,16 @@ function BundleLedger() {
           </div>
         ))}
       </div>
+      <p className="text-ds-body-sm text-text-primary/55">
+        Gzip sizes for minified browser bundles. Renderers include the parser;
+        framework runtimes and highlighters are excluded. Feature sets differ.{' '}
+        <a
+          href="https://github.com/TanStack/markdown/blob/v0.0.14/reports/sizes.md"
+          className="underline underline-offset-4"
+        >
+          Measurement details
+        </a>
+      </p>
     </div>
   )
 }