From aef67f4b234bb9299e96b910a2524b3428ed6dc3 Mon Sep 17 00:00:00 2001
From: Daniel Roe <daniel@roe.dev>
Date: Wed, 18 Feb 2026 21:29:52 +0000
Subject: [PATCH] feat: support markdown versions of pages (#1825)

---
 app/app.vue                                   |   1 +
 app/pages/ai.vue                              |   4 -
 app/pages/ama.vue                             |   2 -
 app/pages/bio.vue                             |   4 -
 app/pages/blog/index.vue                      |   2 -
 app/pages/feed.vue                            |   4 -
 app/pages/feedback.vue                        |   2 -
 app/pages/live.vue                            |   2 -
 app/pages/talks.vue                           |   4 -
 app/pages/uses.vue                            |   4 -
 app/pages/voted.vue                           |   4 -
 app/pages/work.vue                            |   2 -
 modules/markdown.ts                           |  66 ++++++++--
 modules/md-rewrite.ts                         |  39 ++++++
 modules/md-routes.ts                          |  56 ++++++++
 .../md-routes/runtime/server/blog-md.get.ts   |  33 +++++
 modules/router/index.ts                       |  17 +--
 modules/shared/page-meta.ts                   |  49 +++++++
 modules/shared/serialisers.ts                 |  20 ++-
 nuxt.config.ts                                |   2 +-
 server/middleware/md-redirect.ts              |  16 +++
 server/routes/ai.md.get.ts                    |  15 +++
 server/routes/bio.md.get.ts                   |  15 +++
 server/routes/blog.md.get.ts                  |  20 +++
 server/routes/index.md.get.ts                 | 120 ++++++++++++++++++
 server/routes/talks.md.get.ts                 | 101 +++++++++++++++
 server/routes/uses.md.get.ts                  |  70 ++++++++++
 server/routes/work.md.get.ts                  |  81 ++++++++++++
 server/utils/md.ts                            |  58 +++++++++
 test/unit/bundle.spec.ts                      |   2 +-
 30 files changed, 750 insertions(+), 65 deletions(-)
 create mode 100644 modules/md-rewrite.ts
 create mode 100644 modules/md-routes.ts
 create mode 100644 modules/md-routes/runtime/server/blog-md.get.ts
 create mode 100644 modules/shared/page-meta.ts
 create mode 100644 server/middleware/md-redirect.ts
 create mode 100644 server/routes/ai.md.get.ts
 create mode 100644 server/routes/bio.md.get.ts
 create mode 100644 server/routes/blog.md.get.ts
 create mode 100644 server/routes/index.md.get.ts
 create mode 100644 server/routes/talks.md.get.ts
 create mode 100644 server/routes/uses.md.get.ts
 create mode 100644 server/routes/work.md.get.ts
 create mode 100644 server/utils/md.ts

diff --git a/app/app.vue b/app/app.vue
index 562f772f..4c75b76c 100644
--- a/app/app.vue
+++ b/app/app.vue
@@ -145,6 +145,7 @@ if (import.meta.server) {
       { rel: 'mask-icon', color: '#fff', href: '/favicon.svg' },
       { rel: 'icon', type: 'image/svg', href: '/favicon.svg' },
       { rel: 'alternate', type: 'application/rss+xml', href: '/rss.xml' },
+      { rel: 'alternate', type: 'text/markdown', href: `https://roe.dev${path === '/' ? '/index' : withoutTrailingSlash(path)}.md` },
       {
         rel: 'apple-touch-icon',
         sizes: '180x180',
diff --git a/app/pages/ai.vue b/app/pages/ai.vue
index 0925585e..e5038ea5 100644
--- a/app/pages/ai.vue
+++ b/app/pages/ai.vue
@@ -17,7 +17,3 @@
     </main>
   </div>
 </template>
-
-<script lang="ts" setup>
-definePageMeta({ title: 'AI usage' })
-</script>
diff --git a/app/pages/ama.vue b/app/pages/ama.vue
index 2a851f42..01db8b85 100644
--- a/app/pages/ama.vue
+++ b/app/pages/ama.vue
@@ -116,8 +116,6 @@
 </template>
 
 <script lang="ts" setup>
-definePageMeta({ title: 'Ask me anything' })
-
 const status = ref<'idle' | 'pending' | 'error' | 'success'>('idle')
 
 const denialDetected = ref(false)
diff --git a/app/pages/bio.vue b/app/pages/bio.vue
index ea1af9a7..87e1a63c 100644
--- a/app/pages/bio.vue
+++ b/app/pages/bio.vue
@@ -17,7 +17,3 @@
     </main>
   </div>
 </template>
-
-<script lang="ts" setup>
-definePageMeta({ title: 'Bio' })
-</script>
diff --git a/app/pages/blog/index.vue b/app/pages/blog/index.vue
index 69a2343e..8e0e380c 100644
--- a/app/pages/blog/index.vue
+++ b/app/pages/blog/index.vue
@@ -16,8 +16,6 @@
 </template>
 
 <script setup lang="ts">
-definePageMeta({ title: 'Blog' })
-
 const nuxtApp = useNuxtApp()
 onMounted(() => {
   nextTick(() =>
diff --git a/app/pages/feed.vue b/app/pages/feed.vue
index b45cec41..63d6ad4e 100644
--- a/app/pages/feed.vue
+++ b/app/pages/feed.vue
@@ -14,7 +14,3 @@
     </main>
   </div>
 </template>
-
-<script lang="ts" setup>
-definePageMeta({ title: 'Feed' })
-</script>
diff --git a/app/pages/feedback.vue b/app/pages/feedback.vue
index 1dddfb48..cbba4e4d 100644
--- a/app/pages/feedback.vue
+++ b/app/pages/feedback.vue
@@ -57,8 +57,6 @@
 </template>
 
 <script lang="ts" setup>
-definePageMeta({ title: 'Feedback' })
-
 const feedback = ref('')
 const status = ref<'idle' | 'pending' | 'error'>('idle')
 
diff --git a/app/pages/live.vue b/app/pages/live.vue
index 917e5098..60768fbf 100644
--- a/app/pages/live.vue
+++ b/app/pages/live.vue
@@ -80,8 +80,6 @@
 import { ref, onBeforeUnmount } from 'vue'
 import PartySocket from 'partysocket'
 
-definePageMeta({ title: 'Live Reactions' })
-
 const predefinedEmojis = ['👍', '❤️', '😂', '👏', '🔥', '🎉', '🤯', '👨‍💻', '🙌', '🎯', '✅']
 const customEmoji = ref('')
 const displayedReactions = ref<Array<{
diff --git a/app/pages/talks.vue b/app/pages/talks.vue
index e47be65d..2a148a94 100644
--- a/app/pages/talks.vue
+++ b/app/pages/talks.vue
@@ -13,7 +13,3 @@
     </main>
   </div>
 </template>
-
-<script lang="ts" setup>
-definePageMeta({ title: 'Talks' })
-</script>
diff --git a/app/pages/uses.vue b/app/pages/uses.vue
index 6768a11b..c3d58006 100644
--- a/app/pages/uses.vue
+++ b/app/pages/uses.vue
@@ -13,7 +13,3 @@
     </main>
   </div>
 </template>
-
-<script lang="ts" setup>
-definePageMeta({ title: 'Uses' })
-</script>
diff --git a/app/pages/voted.vue b/app/pages/voted.vue
index 6a3a6bb9..9cff22f7 100644
--- a/app/pages/voted.vue
+++ b/app/pages/voted.vue
@@ -21,7 +21,3 @@
     </main>
   </div>
 </template>
-
-<script lang="ts" setup>
-definePageMeta({ title: 'Thank you!' })
-</script>
diff --git a/app/pages/work.vue b/app/pages/work.vue
index 2f8ea97f..4416c63b 100644
--- a/app/pages/work.vue
+++ b/app/pages/work.vue
@@ -67,8 +67,6 @@
 </template>
 
 <script lang="ts" setup>
-definePageMeta({ title: 'Work' })
-
 const ideaText = ref('')
 const ideaStatus = ref<'ready' | 'submitting' | 'submitted' | 'error'>('ready')
 
diff --git a/modules/markdown.ts b/modules/markdown.ts
index e4d55cbd..4e781c36 100644
--- a/modules/markdown.ts
+++ b/modules/markdown.ts
@@ -7,7 +7,7 @@ import { filename } from 'pathe/utils'
 import { remark } from 'remark'
 import remarkHtml from 'remark-html'
 
-import { serializers } from './shared/serialisers'
+import { serialize } from './shared/serialisers'
 
 interface BlogFrontmatter {
   title: string
@@ -165,10 +165,7 @@ export async function getBody () {
     const rssMetadata: Record<string, any> = {}
 
     for (const post of blogPosts) {
-      let contents = post.body
-      for (const [pattern, replacement] of serializers) {
-        contents = contents.replace(pattern, replacement)
-      }
+      const contents = serialize(post.body)
       const date = new Date(post.date)
       rssMetadata[post.slug] = {
         title: post.title,
@@ -187,10 +184,7 @@ export async function getBody () {
     const syncArticles = blogPosts
       .filter(p => !p.skip_dev)
       .map(post => {
-        let body = post.body
-        for (const [pattern, replacement] of serializers) {
-          body = body.replace(pattern, replacement)
-        }
+        const body = serialize(post.body)
         const firstParagraph = post.body.split(/\n\s*\n/).find(p => p.trim())?.trim() || ''
         const date = new Date(post.date)
         return {
@@ -207,9 +201,31 @@ export async function getBody () {
     nuxt.options.nitro.virtual['#sync-articles.json'] = () =>
       `export const syncArticles = ${JSON.stringify(syncArticles)}`
 
+    // Raw blog markdown for .md routes (blog post bodies + frontmatter)
+    const rawBlogData = blogPosts.map(post => ({
+      slug: post.slug,
+      title: post.title,
+      date: typeof post.date === 'string' ? post.date.split('T')[0] : post.date,
+      tags: post.tags,
+      description: post.description,
+      body: serialize(post.body),
+    }))
+
+    nuxt.options.nitro.virtual['#md-raw-blog.json'] = () =>
+      `export const rawBlogPosts = ${JSON.stringify(rawBlogData)}`
+
+    // Raw page markdown for .md routes (ai, bio)
+    const rawPageData: Record<string, string> = {}
+    for (const [slug, body] of Object.entries(pageBodies)) {
+      rawPageData[slug] = serialize(body)
+    }
+
+    nuxt.options.nitro.virtual['#md-raw-pages.json'] = () =>
+      `export const rawPages = ${JSON.stringify(rawPageData)}`
+
     nuxt.options.nitro.externals ||= {}
     nuxt.options.nitro.externals.inline ||= []
-    nuxt.options.nitro.externals.inline.push('#metadata.json', '#sync-articles.json')
+    nuxt.options.nitro.externals.inline.push('#metadata.json', '#sync-articles.json', '#md-raw-blog.json', '#md-raw-pages.json')
 
     // --- Type declarations ---
 
@@ -238,8 +254,36 @@ declare module '#build/markdown/page/index.mjs' {
   import type { MDCParserResult } from '@nuxtjs/mdc'
   export const pageBodyLoaders: Record<string, () => Promise<MDCParserResult>>
 }
+
+declare module '#md-raw-blog.json' {
+  interface RawBlogPost {
+    slug: string
+    title: string
+    date: string
+    tags: string[]
+    description: string
+    body: string
+  }
+  export const rawBlogPosts: RawBlogPost[]
+}
+
+declare module '#md-raw-pages.json' {
+  export const rawPages: Record<string, string>
+}
+
+declare module '#md-page-meta.json' {
+  interface PageMeta {
+    title: string
+    description?: string
+  }
+  export const pageMeta: Record<string, PageMeta>
+}
+
+declare module '#md-pages.json' {
+  export const mdPages: Set<string>
+}
 `,
-    }, { nuxt: true })
+    }, { nuxt: true, nitro: true })
   },
 })
 
diff --git a/modules/md-rewrite.ts b/modules/md-rewrite.ts
new file mode 100644
index 00000000..f3cc189e
--- /dev/null
+++ b/modules/md-rewrite.ts
@@ -0,0 +1,39 @@
+import { defineNuxtModule, useNuxt } from 'nuxt/kit'
+import { readFile, writeFile } from 'node:fs/promises'
+import { resolve } from 'node:path'
+
+export default defineNuxtModule({
+  meta: {
+    name: 'md-rewrite',
+  },
+  setup () {
+    const nuxt = useNuxt()
+
+    nuxt.hook('nitro:init', nitro => {
+      if (nitro.options.dev || !nitro.options.preset.includes('vercel')) {
+        return
+      }
+
+      nitro.hooks.hook('compiled', async () => {
+        const vcJSON = resolve(nitro.options.output.dir, 'config.json')
+        const vcConfig = JSON.parse(await readFile(vcJSON, 'utf8'))
+
+        // Rewrite requests with Accept: text/markdown to the .md version
+        // The home page needs special handling: / -> /index.md
+        vcConfig.routes.unshift({
+          src: '^/$',
+          dest: '/index.md',
+          has: [{ type: 'header', key: 'accept', value: '(.*)text/markdown(.*)' }],
+          check: true,
+        }, {
+          src: '^/(.+?)/?$',
+          dest: '/$1.md',
+          has: [{ type: 'header', key: 'accept', value: '(.*)text/markdown(.*)' }],
+          check: true,
+        })
+
+        await writeFile(vcJSON, JSON.stringify(vcConfig, null, 2), 'utf8')
+      })
+    })
+  },
+})
diff --git a/modules/md-routes.ts b/modules/md-routes.ts
new file mode 100644
index 00000000..a4169b4d
--- /dev/null
+++ b/modules/md-routes.ts
@@ -0,0 +1,56 @@
+import { addServerHandler, createResolver, defineNuxtModule, useNuxt } from 'nuxt/kit'
+import { pageMeta } from './shared/page-meta'
+
+export default defineNuxtModule({
+  meta: {
+    name: 'md-routes',
+  },
+  setup () {
+    const nuxt = useNuxt()
+    const resolver = createResolver(import.meta.url)
+
+    // Expose page meta as a virtual module for server routes
+    nuxt.options.nitro.virtual ||= {}
+    nuxt.options.nitro.virtual['#md-page-meta.json'] = () =>
+      `export const pageMeta = ${JSON.stringify(pageMeta)}`
+
+    const mdPages = [
+      '/',
+      '/ai',
+      '/bio',
+      '/talks',
+      '/uses',
+      '/work',
+      '/blog',
+    ]
+
+    const mdRoutes = mdPages.map(p => p === '/' ? '/index.md' : `${p}.md`)
+
+    nuxt.options.nitro.prerender ||= {}
+    nuxt.options.nitro.prerender.routes ||= []
+    nuxt.options.nitro.prerender.routes.push(...mdRoutes)
+
+    // Register blog post .md handlers once we know all the slugs
+    nuxt.hook('markdown:blog-entries', entries => {
+      for (const entry of entries) {
+        const route = `${entry.path}.md`
+
+        addServerHandler({
+          route,
+          handler: resolver.resolve('./md-routes/runtime/server/blog-md.get'),
+        })
+
+        nuxt.options.nitro.prerender!.routes!.push(route)
+        mdPages.push(entry.path)
+      }
+
+      // Now that all pages are known, expose them for the middleware
+      nuxt.options.nitro.virtual!['#md-pages.json'] = () =>
+        `export const mdPages = new Set(${JSON.stringify(mdPages)})`
+    })
+
+    nuxt.options.nitro.externals ||= {}
+    nuxt.options.nitro.externals.inline ||= []
+    nuxt.options.nitro.externals.inline.push('#md-page-meta.json', '#md-pages.json')
+  },
+})
diff --git a/modules/md-routes/runtime/server/blog-md.get.ts b/modules/md-routes/runtime/server/blog-md.get.ts
new file mode 100644
index 00000000..dbc343e6
--- /dev/null
+++ b/modules/md-routes/runtime/server/blog-md.get.ts
@@ -0,0 +1,33 @@
+import { rawBlogPosts } from '#md-raw-blog.json'
+
+export default defineEventHandler(event => {
+  const url = getRequestURL(event)
+  const match = url.pathname.match(/\/blog\/(.+)\.md$/)
+  const slug = match?.[1]
+
+  const post = slug ? rawBlogPosts.find(p => p.slug === slug) : undefined
+  if (!post) {
+    throw createError({ statusCode: 404, statusMessage: 'Not found' })
+  }
+
+  const tagStr = post.tags.length
+    ? `tags: [${post.tags.join(', ')}]`
+    : 'tags: []'
+
+  const esc = (s: string) => s.replace(/\\/g, '\\\\').replace(/"/g, '\\"')
+
+  const md = [
+    '---',
+    `title: "${esc(post.title)}"`,
+    `date: ${post.date}`,
+    tagStr,
+    `description: "${esc(post.description)}"`,
+    `url: https://roe.dev/blog/${post.slug}`,
+    '---',
+    '',
+    mdInternalLinks(post.body.trim()),
+    '',
+  ].join('\n')
+
+  return mdResponse(md)
+})
diff --git a/modules/router/index.ts b/modules/router/index.ts
index 8e622b28..574faed6 100644
--- a/modules/router/index.ts
+++ b/modules/router/index.ts
@@ -19,20 +19,7 @@ import {
 } from 'nuxt/kit'
 import { withLeadingSlash } from 'ufo'
 
-const routeMeta: Record<string, Record<string, any>> = {
-  '/blog': {
-    title: 'Blog',
-  },
-  '/talks': {
-    title: 'Talks',
-  },
-  '/uses': {
-    title: 'Uses',
-  },
-  '/work': {
-    title: 'Work',
-  },
-}
+import { pageMeta } from '../shared/page-meta'
 
 export default defineNuxtModule({
   meta: {
@@ -103,7 +90,7 @@ export default defineNuxtModule({
             //   interopDefault: true,
             // })})`,
             component: componentNames[f],
-            meta: JSON.stringify(routeMeta[path] || {}),
+            meta: JSON.stringify(pageMeta[path] || {}),
           }
         })
 
diff --git a/modules/shared/page-meta.ts b/modules/shared/page-meta.ts
new file mode 100644
index 00000000..0869438d
--- /dev/null
+++ b/modules/shared/page-meta.ts
@@ -0,0 +1,49 @@
+export interface PageMeta {
+  title: string
+  description?: string
+}
+
+export const pageMeta: Record<string, PageMeta> = {
+  '/': {
+    title: 'Daniel Roe',
+    description: 'The personal website of Daniel Roe, Nuxt core team lead',
+  },
+  '/ai': {
+    title: 'AI Usage',
+  },
+  '/ama': {
+    title: 'Ask me anything',
+  },
+  '/bio': {
+    title: 'Bio',
+    description: 'Biography of Daniel Roe',
+  },
+  '/blog': {
+    title: 'Blog',
+    description: 'Blog posts by Daniel Roe',
+  },
+  '/feed': {
+    title: 'Feed',
+  },
+  '/feedback': {
+    title: 'Feedback',
+  },
+  '/live': {
+    title: 'Live Reactions',
+  },
+  '/talks': {
+    title: 'Talks',
+    description: 'Talks and presentations by Daniel Roe',
+  },
+  '/uses': {
+    title: 'Uses',
+    description: 'Tools, software, and hardware that Daniel Roe uses',
+  },
+  '/voted': {
+    title: 'Thank you!',
+  },
+  '/work': {
+    title: 'Work',
+    description: 'Open source projects and past client work by Daniel Roe',
+  },
+}
diff --git a/modules/shared/serialisers.ts b/modules/shared/serialisers.ts
index 0461fb92..9f4b3166 100644
--- a/modules/shared/serialisers.ts
+++ b/modules/shared/serialisers.ts
@@ -1,7 +1,21 @@
-export const serializers = new Map([
+type Replacement = string | ((...args: string[]) => string)
+
+export const serializers = new Map<RegExp, Replacement>([
   [/\(\//g, '(https://roe.dev/'],
   [/ ---? /g, ' — '],
-  [/::SocialPost\{link=([^ ]*)[\s\S]*?::/g, '$1'],
-  [/:CalSchedule\{meeting=([^ ]*).*\}/g, 'https://cal.com/danielroe/$1'],
+  [/::(?:social-post|SocialPost)\{link=([^ ]*)(?:[^}]*)}\n([\s\S]*?)::/g, (_: string, link: string, body: string) => {
+    const quoted = body.trim().split('\n').map((line: string) => `> ${line}`).join('\n')
+    return `${quoted}\n>\n> — [source](${link})`
+  }],
+  [/:(?:cal-schedule|CalSchedule)\{meeting=([^ ]*).*\}/g, 'https://cal.com/danielroe/$1'],
   [/(\n|^)---\n[\s\S]*\n---\n/, '\n'],
 ])
+
+/** Apply all serializers to a string. */
+export function serialize (input: string): string {
+  let result = input
+  for (const [pattern, replacement] of serializers) {
+    result = result.replace(pattern, replacement as string)
+  }
+  return result
+}
diff --git a/nuxt.config.ts b/nuxt.config.ts
index e93b59c2..bc68e7b7 100644
--- a/nuxt.config.ts
+++ b/nuxt.config.ts
@@ -188,7 +188,7 @@ export default defineNuxtConfig({
       'prerender:generate' (route) {
         if (route.fileName)
           route.fileName = route.fileName.replace(
-            /(\.\w{3})\/index.html$/,
+            /(\.\w{2,3})\/index.html$/,
             '$1',
           )
 
diff --git a/server/middleware/md-redirect.ts b/server/middleware/md-redirect.ts
new file mode 100644
index 00000000..e0fc5a22
--- /dev/null
+++ b/server/middleware/md-redirect.ts
@@ -0,0 +1,16 @@
+import { mdPages } from '#md-pages.json'
+
+export default defineEventHandler(event => {
+  if (event.method !== 'GET') return
+
+  const accept = getRequestHeader(event, 'accept') || ''
+  if (!accept.includes('text/markdown')) return
+
+  if (event.path.endsWith('.md')) return
+
+  const clean = event.path.replace(/\/$/, '') || '/'
+  if (!mdPages.has(clean)) return
+
+  const dest = clean === '/' ? '/index.md' : `${clean}.md`
+  return sendRedirect(event, dest, 302)
+})
diff --git a/server/routes/ai.md.get.ts b/server/routes/ai.md.get.ts
new file mode 100644
index 00000000..b43e2ae6
--- /dev/null
+++ b/server/routes/ai.md.get.ts
@@ -0,0 +1,15 @@
+import { rawPages } from '#md-raw-pages.json'
+import { pageMeta } from '#md-page-meta.json'
+
+export default defineEventHandler(() => {
+  const body = rawPages['ai'] || ''
+
+  const md = [
+    mdFrontmatter('/ai', pageMeta['/ai']!),
+    '',
+    mdInternalLinks(mdCleanHtml(body)),
+    '',
+  ].join('\n')
+
+  return mdResponse(md)
+})
diff --git a/server/routes/bio.md.get.ts b/server/routes/bio.md.get.ts
new file mode 100644
index 00000000..901ba4bf
--- /dev/null
+++ b/server/routes/bio.md.get.ts
@@ -0,0 +1,15 @@
+import { rawPages } from '#md-raw-pages.json'
+import { pageMeta } from '#md-page-meta.json'
+
+export default defineEventHandler(() => {
+  const body = rawPages['bio'] || ''
+
+  const md = [
+    mdFrontmatter('/bio', pageMeta['/bio']!),
+    '',
+    mdInternalLinks(mdCleanHtml(body)),
+    '',
+  ].join('\n')
+
+  return mdResponse(md)
+})
diff --git a/server/routes/blog.md.get.ts b/server/routes/blog.md.get.ts
new file mode 100644
index 00000000..679c1338
--- /dev/null
+++ b/server/routes/blog.md.get.ts
@@ -0,0 +1,20 @@
+import { rawBlogPosts } from '#md-raw-blog.json'
+import { pageMeta } from '#md-page-meta.json'
+
+export default defineEventHandler(() => {
+  const lines = [
+    mdFrontmatter('/blog', pageMeta['/blog']!),
+    '',
+  ]
+
+  for (const post of rawBlogPosts) {
+    lines.push(`- [${post.title}](https://roe.dev/blog/${post.slug}.md) — ${post.date}`)
+    if (post.description) {
+      lines.push(`  ${post.description}`)
+    }
+  }
+
+  lines.push('')
+
+  return mdResponse(lines.join('\n'))
+})
diff --git a/server/routes/index.md.get.ts b/server/routes/index.md.get.ts
new file mode 100644
index 00000000..0460e855
--- /dev/null
+++ b/server/routes/index.md.get.ts
@@ -0,0 +1,120 @@
+import { rawBlogPosts } from '#md-raw-blog.json'
+import { pageMeta } from '#md-page-meta.json'
+
+export default defineEventHandler(async () => {
+  if (import.meta.test) {
+    return mdResponse('')
+  }
+
+  const [talks, upcomingConferences] = await Promise.all([
+    $fetch<Talk[]>('/api/talks').catch(() => [] as Talk[]),
+    $fetch<Conference[]>('/api/upcoming-conferences').catch(() => [] as Conference[]),
+  ])
+
+  // Group talks and take top 4
+  const groupedTalks: Record<string, Talk[]> = {}
+  for (const talk of talks) {
+    const groupKey = talk.group?._id || talk._id
+    groupedTalks[groupKey] ||= []
+    groupedTalks[groupKey]!.push(talk)
+  }
+  const recentTalks = Object.values(groupedTalks)
+    .map(g => g.sort((a, b) => new Date(b.date).getTime() - new Date(a.date).getTime())[0]!)
+    .sort((a, b) => new Date(b.date).getTime() - new Date(a.date).getTime())
+    .slice(0, 4)
+
+  const recentPosts = rawBlogPosts.slice(0, 4)
+
+  const lines = [
+    mdFrontmatter('/', pageMeta['/']!),
+    '',
+    'I am an open source maintainer and founder, leading the [Nuxt core team](https://nuxt.com). Previously, I was CTO of a SaaS startup and founder of a creative agency focusing on clarity of vision and message.',
+    '',
+    '[More about Daniel](https://roe.dev/bio.md)',
+    '',
+    '## Links',
+    '',
+    '- [GitHub](https://github.com/danielroe/)',
+    '- [Bluesky](https://bsky.app/profile/danielroe.dev)',
+    '- [LinkedIn](https://www.linkedin.com/in/daniel-roe/)',
+    '- [Mastodon](https://mastodon.roe.dev/@daniel)',
+    '- [YouTube](https://www.youtube.com/@danielroe)',
+    '- [Twitch](https://twitch.tv/danielroe)',
+    '- [Email](mailto:daniel@roe.dev)',
+    '',
+  ]
+
+  if (upcomingConferences.length) {
+    lines.push('## Upcoming Conferences')
+    lines.push('')
+    for (const conf of upcomingConferences) {
+      const link = conf.link ? `[${conf.name}](${conf.link})` : conf.name
+      lines.push(`- ${link} — ${conf.dates}${conf.location ? ` (${conf.location})` : ''}`)
+    }
+    lines.push('')
+  }
+
+  if (recentTalks.length) {
+    lines.push('## Recent Talks')
+    lines.push('')
+    for (const talk of recentTalks) {
+      const talkLinks: string[] = []
+      if (talk.video) talkLinks.push(`[Video](${talk.video})`)
+      if (talk.link) talkLinks.push(`[Link](${talk.link})`)
+      const suffix = talkLinks.length ? ` — ${talkLinks.join(', ')}` : ''
+      lines.push(`- ${talk.title} (${formatDate(talk.date)})${suffix}`)
+    }
+    lines.push('')
+    lines.push('[More talks](https://roe.dev/talks.md)')
+    lines.push('')
+  }
+
+  if (recentPosts.length) {
+    lines.push('## Latest from the Blog')
+    lines.push('')
+    for (const post of recentPosts) {
+      lines.push(`- [${post.title}](https://roe.dev/blog/${post.slug}.md) — ${post.date}`)
+    }
+    lines.push('')
+    lines.push('[More articles](https://roe.dev/blog.md)')
+    lines.push('')
+  }
+
+  lines.push('## Contact')
+  lines.push('')
+  lines.push('I\'d love to connect on social media or [by email](mailto:daniel@roe.dev). I have an open diary if you want to [book a meeting](https://roe.dev/blog/open-invitation.md).')
+  lines.push('')
+  lines.push('## Sponsors')
+  lines.push('')
+  lines.push('My open source work is supported by sponsors. [More about how I\'m funded](https://roe.dev/blog/funding.md).')
+  lines.push('')
+
+  return mdResponse(lines.join('\n'))
+})
+
+function formatDate (dateStr: string): string {
+  const date = new Date(dateStr)
+  return date.toLocaleDateString('en-GB', {
+    day: 'numeric',
+    month: 'long',
+    year: 'numeric',
+  })
+}
+
+interface Talk {
+  _id: string
+  title: string
+  source: string
+  link?: string
+  video?: string
+  date: string
+  type: string
+  group?: { _id: string }
+}
+
+interface Conference {
+  name: string
+  dates: string
+  link?: string
+  location?: string
+}
diff --git a/server/routes/talks.md.get.ts b/server/routes/talks.md.get.ts
new file mode 100644
index 00000000..1e89bd19
--- /dev/null
+++ b/server/routes/talks.md.get.ts
@@ -0,0 +1,101 @@
+import { pageMeta } from '#md-page-meta.json'
+
+export default defineEventHandler(async () => {
+  if (import.meta.test) {
+    return mdResponse('')
+  }
+
+  const talks = await $fetch<Talk[]>('/api/talks')
+
+  // Group talks the same way the page does
+  const groupedTalks: Record<string, Talk[]> = {}
+  for (const talk of talks) {
+    const groupKey = talk.group?._id || talk._id
+    groupedTalks[groupKey] ||= []
+    groupedTalks[groupKey]!.push(talk)
+  }
+
+  const groups = Object.values(groupedTalks)
+    .map(talksInGroup => talksInGroup.sort((a, b) => new Date(b.date).getTime() - new Date(a.date).getTime()))
+    .sort((a, b) => new Date(b[0]!.date).getTime() - new Date(a[0]!.date).getTime())
+
+  const lines = [
+    mdFrontmatter('/talks', pageMeta['/talks']!),
+    '',
+  ]
+
+  for (const group of groups) {
+    const primary = group[0]!
+    lines.push(`## ${primary.title}`)
+    lines.push('')
+
+    if (primary.description) {
+      lines.push(primary.description)
+      lines.push('')
+    }
+
+    if (primary.source) {
+      lines.push(`- **Source:** ${primary.source}`)
+    }
+    lines.push(`- **Date:** ${formatDate(primary.date)}`)
+    if (primary.type) {
+      lines.push(`- **Type:** ${primary.type}`)
+    }
+
+    const links: string[] = []
+    if (primary.video) links.push(`[Video](${primary.video})`)
+    if (primary.link) links.push(`[Link](${primary.link})`)
+    if (primary.slides) links.push(`[Slides](https://roe.dev/slides/${primary.slides}.pdf)`)
+    if (primary.demo) links.push(`[Demo](${primary.demo})`)
+    if (primary.repo) links.push(`[Repo](${primary.repo})`)
+    if (links.length) {
+      lines.push(`- ${links.join(' | ')}`)
+    }
+
+    // If this is a group with multiple presentations, list them
+    if (group.length > 1) {
+      lines.push('')
+      lines.push('Also presented at:')
+      for (const talk of group.slice(1)) {
+        const talkLinks: string[] = []
+        if (talk.video) talkLinks.push(`[Video](${talk.video})`)
+        if (talk.link) talkLinks.push(`[Link](${talk.link})`)
+        const suffix = talkLinks.length ? ` — ${talkLinks.join(' | ')}` : ''
+        lines.push(`- ${talk.source || talk.title} (${formatDate(talk.date)})${suffix}`)
+      }
+    }
+
+    lines.push('')
+  }
+
+  return mdResponse(lines.join('\n'))
+})
+
+function formatDate (dateStr: string): string {
+  const date = new Date(dateStr)
+  return date.toLocaleDateString('en-GB', {
+    day: 'numeric',
+    month: 'long',
+    year: 'numeric',
+  })
+}
+
+interface Talk {
+  _id: string
+  title: string
+  description?: string
+  source: string
+  tags: string[]
+  link?: string
+  video?: string
+  date: string
+  type: string
+  slides?: string
+  repo?: string
+  demo?: string
+  group?: {
+    _id: string
+    title: string
+    description?: string
+  }
+}
diff --git a/server/routes/uses.md.get.ts b/server/routes/uses.md.get.ts
new file mode 100644
index 00000000..b70a1f2c
--- /dev/null
+++ b/server/routes/uses.md.get.ts
@@ -0,0 +1,70 @@
+import { pageMeta } from '#md-page-meta.json'
+
+export default defineEventHandler(async event => {
+  if (import.meta.test) {
+    return mdResponse('')
+  }
+
+  const sanity = useSanity(event)
+  const categories = await sanity.client.fetch<UsesCategory[]>(`
+    *[_type == "uses"] {
+      _id,
+      category,
+      order,
+      items[] {
+        name,
+        description,
+        links[] {
+          url,
+          label
+        },
+        order
+      }
+    }
+  `)
+
+  const sorted = [...categories].sort((a, b) => (a.order || 100) - (b.order || 100))
+
+  const lines = [
+    mdFrontmatter('/uses', pageMeta['/uses']!),
+    '',
+  ]
+
+  for (const category of sorted) {
+    lines.push(`## ${category.category}`)
+    lines.push('')
+
+    const items = [...(category.items || [])].sort((a, b) => (a.order || 100) - (b.order || 100))
+    for (const item of items) {
+      const primaryLink = item.links?.[0]?.url
+      const name = primaryLink ? `[${item.name}](${primaryLink})` : item.name
+      const desc = item.description ? ` — ${item.description}` : ''
+      lines.push(`- **${name}**${desc}`)
+
+      // Additional links beyond the primary
+      const extraLinks = item.links?.slice(1)
+      if (extraLinks?.length) {
+        const linkStr = extraLinks.map(l => `[${l.label || 'Link'}](${l.url})`).join(', ')
+        lines.push(`  ${linkStr}`)
+      }
+    }
+
+    lines.push('')
+  }
+
+  return mdResponse(lines.join('\n'))
+})
+
+interface UsesCategory {
+  _id: string
+  category: string
+  order: number
+  items: UsesItem[]
+}
+
+interface UsesItem {
+  name: string
+  description?: string
+  links?: { url: string, label?: string }[]
+  order?: number
+}
diff --git a/server/routes/work.md.get.ts b/server/routes/work.md.get.ts
new file mode 100644
index 00000000..3f86f810
--- /dev/null
+++ b/server/routes/work.md.get.ts
@@ -0,0 +1,81 @@
+import { pageMeta } from '#md-page-meta.json'
+
+export default defineEventHandler(async () => {
+  const repos = [
+    'nuxt/nuxt',
+    'danielroe/magic-regexp',
+    'danielroe/fontaine',
+    'danielroe/nuxt-vitest',
+  ]
+
+  const clients = [
+    'Comcast',
+    'Durham University',
+    'Parent Scheme',
+    'Concision',
+    'North East Local Enterprise Partnership',
+    'Convoke',
+    'Acadian Software',
+    'NuxtLabs',
+    'Canvas8',
+    'Imperial Enterprise Lab',
+  ]
+
+  const config = useRuntimeConfig()
+  const formatter = new Intl.NumberFormat('en-GB', {
+    notation: 'compact',
+    compactDisplay: 'short',
+  })
+
+  const repoData = await Promise.all(
+    repos.map(async repo => {
+      if (import.meta.dev || import.meta.test) {
+        return { repo, stars: '1.4K', language: 'TypeScript' }
+      }
+      try {
+        const { stargazers_count: stars, language, description } = await $fetch<any>(
+          `https://api.github.com/repos/${repo}`,
+          {
+            headers: {
+              Accept: 'application/vnd.github.v3+json',
+              Authorization: `Bearer ${config.github.token}`,
+            },
+          },
+        )
+        return { repo, stars: formatter.format(stars), language, description }
+      }
+      catch {
+        return { repo, stars: '', language: '', description: '' }
+      }
+    }),
+  )
+
+  const lines = [
+    mdFrontmatter('/work', pageMeta['/work']!),
+    '',
+    '## Open Source',
+    '',
+  ]
+
+  for (const { repo, stars, language, description } of repoData) {
+    const parts = [`**[${repo}](https://github.com/${repo})**`]
+    if (description) parts.push(` — ${description}`)
+    const meta: string[] = []
+    if (stars) meta.push(`${stars} stars`)
+    if (language) meta.push(language)
+    if (meta.length) parts.push(` (${meta.join(', ')})`)
+    lines.push(`- ${parts.join('')}`)
+  }
+
+  lines.push('')
+  lines.push('## Past Clients')
+  lines.push('')
+
+  for (const client of clients) {
+    lines.push(`- ${client}`)
+  }
+
+  lines.push('')
+
+  return mdResponse(lines.join('\n'))
+})
diff --git a/server/utils/md.ts b/server/utils/md.ts
new file mode 100644
index 00000000..1083630c
--- /dev/null
+++ b/server/utils/md.ts
@@ -0,0 +1,58 @@
+const SITE_URL = 'https://roe.dev'
+
+function yamlEscape (str: string): string {
+  return str.replace(/\\/g, '\\\\').replace(/"/g, '\\"')
+}
+
+export function mdFrontmatter (path: string, meta: { title: string, description?: string }): string {
+  const lines = ['---']
+  lines.push(`title: "${yamlEscape(meta.title)}"`)
+  if (meta.description) {
+    lines.push(`description: "${yamlEscape(meta.description)}"`)
+  }
+  lines.push(`url: ${SITE_URL}${path}`)
+  lines.push('---')
+  return lines.join('\n')
+}
+
+export function mdInternalLinks (content: string): string {
+  return content.replace(
+    /\]\(https:\/\/roe\.dev(\/[^)]*?)\)/g,
+    (_match, path: string) => {
+      // Skip non-page resources
+      if (/\.(xml|png|jpg|jpeg|svg|webp|pdf|webmanifest|json|css|js)$/i.test(path)) return `](${SITE_URL}${path})`
+      if (path.startsWith('/.well-known/')) return `](${SITE_URL}${path})`
+      if (path.endsWith('.md')) return `](${SITE_URL}${path})`
+      // Skip mailto and other non-path links
+      if (path.includes('@')) return `](${SITE_URL}${path})`
+
+      // Normalise trailing slash
+      const clean = path.replace(/\/$/, '') || '/index'
+      return `](${SITE_URL}${clean}.md)`
+    },
+  )
+}
+
+export function mdCleanHtml (content: string): string {
+  return content
+    // Convert <img> wrapped in a <p> to markdown image
+    .replace(/<p[^>]*><img[^>]*src="([^"]*)"[^>]*alt="([^"]*)"[^>]*><\/p>/g, '![$2]($1)')
+    // Convert standalone <img> to markdown image
+    .replace(/<img[^>]*src="([^"]*)"[^>]*alt="([^"]*)"[^>]*>/g, '![$2]($1)')
+    // Strip opening div/span tags (keep content)
+    .replace(/<(?:div|span)[^>]*>/g, '')
+    // Strip closing div/span tags
+    .replace(/<\/(?:div|span)>/g, '')
+    // Strip <p> with only classes (presentational)
+    .replace(/<p[^>]*class="[^"]*"[^>]*>/g, '')
+    .replace(/<\/p>/g, '')
+    // Collapse multiple blank lines left behind
+    .replace(/\n{3,}/g, '\n\n')
+    .trim()
+}
+
+export function mdResponse (content: string): Response {
+  return new Response(content, {
+    headers: { 'Content-Type': 'text/markdown; charset=utf-8' },
+  })
+}
diff --git a/test/unit/bundle.spec.ts b/test/unit/bundle.spec.ts
index 1977af60..a75cce7d 100644
--- a/test/unit/bundle.spec.ts
+++ b/test/unit/bundle.spec.ts
@@ -78,7 +78,7 @@ describe('project sizes', () => {
     stats.server = await analyzeSizes(['**/*.mjs', '!node_modules'], serverDir)
     expect
       .soft(roundToKilobytes(stats.server.totalBytes))
-      .toMatchInlineSnapshot(`"2234k"`)
+      .toMatchInlineSnapshot(`"2332k"`)
 
     const modules = await analyzeSizes('node_modules/**/*', serverDir)
     expect
-- 
2.51.2