up

Author: HugoRCD

app/app.vue

@@ -31,17 +31,43 @@ useHead({
   ]
 })
 
+const route = useRoute()
+const site = useSiteConfig()
+const canonicalUrl = computed(() => `${site.url}${route.path}`)
+
 if (import.meta.server) {
   useHead({
     meta: [
       { name: 'viewport', content: 'width=device-width, initial-scale=1' }
     ],
     link: [
-      { rel: 'icon', type: 'image/png', href: '/icon.png' }
+      { rel: 'icon', type: 'image/png', href: '/icon.png' },
+      { rel: 'canonical', href: canonicalUrl }
     ],
     htmlAttrs: {
       lang: 'en'
-    }
+    },
+    script: [
+      {
+        type: 'application/ld+json',
+        innerHTML: JSON.stringify({
+          '@context': 'https://schema.org',
+          '@type': 'WebSite',
+          'name': 'Nuxt',
+          'url': site.url,
+          'description': 'The Intuitive Vue Framework. Nuxt is a free and open-source framework to create type-safe, performant and production-grade full-stack web applications and websites with Vue.js.',
+          'publisher': {
+            '@type': 'Organization',
+            'name': 'Nuxt',
+            'url': site.url,
+            'logo': {
+              '@type': 'ImageObject',
+              'url': `${site.url}/icon.png`
+            }
+          }
+        })
+      }
+    ]
   })
   useSeoMeta({
     ogSiteName: 'Nuxt',

modules/md-rewrite.ts

@@ -1,4 +1,9 @@
 import { defineNuxtModule } from 'nuxt/kit'
+import { AI_AGENT_UA_PATTERNS } from '@vercel/agent-readability'
+
+function buildAgentUARegex(): string {
+  return `(?i).*(${AI_AGENT_UA_PATTERNS.join('|')}).*`
+}
 
 function mdRewrite(nitro) {
   if (nitro.options.dev || !nitro.options.preset.includes('vercel')) {
@@ -10,41 +15,33 @@ function mdRewrite(nitro) {
       = process.getBuiltinModule('node:fs/promises')
     const vcJSON = resolve(nitro.options.output.dir, 'config.json')
     const vcConfig = JSON.parse(await readFile(vcJSON, 'utf8'))
+
+    const agentUA = buildAgentUARegex()
+    const agentHas = [{ type: 'header', key: 'user-agent', value: agentUA }]
+    const acceptMd = [{ type: 'header', key: 'accept', value: '(.*)text/markdown(.*)' }]
+
+    const skipPattern = '^(?!/api/|/_nuxt/|/__nuxt|/raw/|/agent-md/)(.*)$'
+
+    // --- Catch-all Agent UA detection → rewrite to /agent-md/ ---
     vcConfig.routes.unshift({
-      src: '^/docs/(.*)$',
-      dest: '/raw/docs/$1.md',
-      has: [{ type: 'header', key: 'accept', value: '(.*)text/markdown(.*)' }],
-      check: true
-    })
-    vcConfig.routes.unshift({
-      src: '^/deploy/(.*)$',
-      dest: '/raw/deploy/$1.md',
-      has: [{ type: 'header', key: 'accept', value: '(.*)text/markdown(.*)' }],
-      check: true
-    })
-    vcConfig.routes.unshift({
-      src: '^/blog/(.*)$',
-      dest: '/raw/blog/$1.md',
-      has: [{ type: 'header', key: 'accept', value: '(.*)text/markdown(.*)' }],
-      check: true
-    })
-    vcConfig.routes.unshift({
-      src: '^/modules/?$',
-      dest: '/modules.md',
-      has: [{ type: 'header', key: 'accept', value: '(.*)text/markdown(.*)' }],
-      check: true
+      src: skipPattern,
+      dest: '/agent-md/$1',
+      has: agentHas
     })
+
+    // --- Accept: text/markdown header → rewrite to /agent-md/ ---
     vcConfig.routes.unshift({
-      src: '^/changelog/?$',
-      dest: '/changelog.md',
-      has: [{ type: 'header', key: 'accept', value: '(.*)text/markdown(.*)' }],
-      check: true
+      src: skipPattern,
+      dest: '/agent-md/$1',
+      has: acceptMd
     })
+
+    // --- Explicit .md extension requests → rewrite to /agent-md/ ---
     vcConfig.routes.unshift({
-      src: '^/(docs|deploy|blog)/(.*)\\.md$',
-      dest: '/raw/$1/$2.md',
-      check: true
+      src: '^/(.*)\\.md$',
+      dest: '/agent-md/$1'
     })
+
     await writeFile(vcJSON, JSON.stringify(vcConfig, null, 2), 'utf8')
   })
 }

nuxt.config.ts

@@ -27,6 +27,9 @@ export default defineNuxtConfig({
     '@vercel/analytics',
     '@vercel/speed-insights'
   ],
+  site: {
+    url: 'https://nuxt.com'
+  },
   $development: {
     site: {
       url: 'http://localhost:3000'
@@ -106,13 +109,16 @@ export default defineNuxtConfig({
     resend: {
       apiKey: '',
       audienceId: ''
+    },
+    mdTracking: {
+      url: '',
+      apiKey: ''
     }
   },
   routeRules: {
     // Pre-render
     '/': { prerender: true },
     '/blog/rss.xml': { prerender: true },
-    '/sitemap.xml': { prerender: true },
     '/sitemap.md': { prerender: true },
     '/404.html': { prerender: true },
     '/docs/3.x/getting-started/introduction': { prerender: true },

package.json

@@ -53,6 +53,7 @@
     "drizzle-orm": "^0.45.1",
     "feed": "^5.2.0",
     "h3": "^1.15.6",
+    "html2canvas-pro": "^2.0.2",
     "little-date": "^1.2.1",
     "motion-v": "^1.10.3",
     "nuxt": "^4.4.2",

pnpm-lock.yaml

@@ -1,52 +1,54 @@
 import { shouldServeMarkdown, generateNotFoundMarkdown } from '@vercel/agent-readability'
+import { trackMdRequest, extractTrackingContext, resolveSource } from '~~/server/utils/md-tracking'
 
-const CONTENT_PREFIXES = ['/docs/', '/deploy/', '/blog/']
+const SKIP_PREFIXES = ['/api/', '/_nuxt/', '/__nuxt', '/raw/', '/agent-md/']
+
+const NOT_FOUND_OPTIONS = {
+  baseUrl: 'https://nuxt.com',
+  sitemapUrl: '/sitemap.md',
+  indexUrl: '/llms.txt',
+  fullContentUrl: '/llms-full.txt',
+  exampleUrl: '/docs/4.x/getting-started/introduction.md'
+}
+
+function respondMarkdown(event: Parameters<typeof setResponseHeader>[0], body: string, reason: string) {
+  setResponseHeader(event, 'Content-Type', 'text/markdown; charset=utf-8')
+  setResponseHeader(event, 'Vary', 'Accept, User-Agent')
+  setResponseHeader(event, 'X-Agent-Readability', reason)
+  return body
+}
 
 export default defineEventHandler(async (event) => {
   const url = getRequestURL(event)
-  const pathname = url.pathname
+  let pathname = url.pathname
 
-  if (pathname.endsWith('.md') || pathname.startsWith('/raw/')) return
-  if (pathname.startsWith('/api/') || pathname.startsWith('/_nuxt/') || pathname.startsWith('/__nuxt')) return
+  if (SKIP_PREFIXES.some(p => pathname.startsWith(p))) return
+  if (/\.(?:js|css|ico|png|jpg|svg|woff2|json|xml|txt)$/.test(pathname)) return
 
-  const request = toWebRequest(event)
-  const { serve, reason } = shouldServeMarkdown(request)
-  if (!serve) return
+  if (pathname.endsWith('.md')) {
+    pathname = pathname.slice(0, -3)
+  }
 
-  let mdRoute: string | null = null
+  const request = toWebRequest(event)
+  const { serve, reason, detection } = shouldServeMarkdown(request)
 
-  for (const prefix of CONTENT_PREFIXES) {
-    if (pathname.startsWith(prefix)) {
-      mdRoute = `/raw${pathname}.md`
-      break
-    }
-  }
+  if (!serve && !url.pathname.endsWith('.md')) return
 
-  if (!mdRoute) {
-    if (pathname === '/modules' || pathname === '/modules/') mdRoute = '/modules.md'
-    else if (pathname === '/changelog' || pathname === '/changelog/') mdRoute = '/changelog.md'
-  }
+  const ctx = extractTrackingContext(event)
+  const requestType = url.pathname.endsWith('.md')
+    ? 'md-url' as const
+    : reason === 'accept-header'
+      ? 'header-negotiated' as const
+      : 'agent-rewrite' as const
 
-  if (!mdRoute) return
+  const effectiveReason = reason || 'md-url'
 
   try {
-    const md = await $fetch<string>(mdRoute)
-    setResponseHeader(event, 'Content-Type', 'text/markdown; charset=utf-8')
-    setResponseHeader(event, 'Vary', 'Accept, User-Agent')
-    setResponseHeader(event, 'X-Agent-Readability', reason)
-    return md
-  }
-  catch {
-    const notFound = generateNotFoundMarkdown(pathname, {
-      baseUrl: 'https://nuxt.com',
-      sitemapUrl: '/sitemap.md',
-      indexUrl: '/llms.txt',
-      fullContentUrl: '/llms-full.txt',
-      exampleUrl: '/docs/4.x/getting-started/introduction.md'
-    })
-    setResponseHeader(event, 'Content-Type', 'text/markdown; charset=utf-8')
-    setResponseHeader(event, 'Vary', 'Accept, User-Agent')
-    setResponseHeader(event, 'X-Agent-Readability', `${reason}-not-found`)
-    return notFound
+    const md = await $fetch<string>(`/agent-md${pathname}`)
+    trackMdRequest(event, { ...ctx, path: pathname, source: resolveSource(pathname), requestType, detectionMethod: detection.method })
+    return respondMarkdown(event, md, effectiveReason)
+  } catch {
+    trackMdRequest(event, { ...ctx, path: pathname, source: 'agent-404', requestType, detectionMethod: detection.method })
+    return respondMarkdown(event, generateNotFoundMarkdown(pathname, NOT_FOUND_OPTIONS), effectiveReason)
   }
 })