Note
\n\n${body.trim()}\n\n
Warning
\n\n${body.trim()}\n\n
Critical
\n\n${body.trim()}\n\n
+
+
diff --git a/nuxt/server/middleware/legacy.ts b/nuxt/server/middleware/legacy.ts
index ca923de05b..359cdb38c6 100644
--- a/nuxt/server/middleware/legacy.ts
+++ b/nuxt/server/middleware/legacy.ts
@@ -5,7 +5,7 @@ import { proxyRequest } from 'h3'
const NUXT_ROUTES = new Set(['/terms', '/privacy-policy', '/resources/publications'])
// Route prefixes handled by Nuxt (all paths starting with these are served by Nuxt).
-const NUXT_PREFIXES = ['/handbook', '/ebooks', '/whitepaper']
+const NUXT_PREFIXES = ['/handbook', '/ebooks', '/whitepaper', '/docs']
export default defineEventHandler(async (event) => {
if (process.env.NODE_ENV !== 'development') return
diff --git a/nuxt/utils/remark-docs-links.ts b/nuxt/utils/remark-docs-links.ts
new file mode 100644
index 0000000000..4f61f0cbc5
--- /dev/null
+++ b/nuxt/utils/remark-docs-links.ts
@@ -0,0 +1,61 @@
+import { visit } from 'unist-util-visit'
+import type { Root } from 'mdast'
+import type { VFile } from 'vfile'
+
+function posixDirname(path: string): string {
+ const i = path.lastIndexOf('/')
+ return i <= 0 ? '/' : path.slice(0, i)
+}
+
+function posixResolve(base: string, rel: string): string {
+ const parts = (base + rel).split('/')
+ const out: string[] = []
+ for (const p of parts) {
+ if (p === '..') out.pop()
+ else if (p !== '.') out.push(p)
+ }
+ return '/' + out.filter(Boolean).join('/')
+}
+
+// Converts relative image/link URLs in docs markdown to absolute /docs/... paths.
+// Needed because @nuxt/content serves pages with trailing-slash URLs which
+// would mis-resolve relative paths without this fix.
+export default function remarkDocsLinks() {
+ return (tree: Root, file: VFile) => {
+ const filePath: string = (file.path || file.history?.[0] || '') as string
+ if (!filePath.includes('/docs/')) return
+
+ const docsIdx = filePath.lastIndexOf('/docs/')
+ const relPath = filePath.slice(docsIdx)
+ const baseDir = posixDirname(relPath) + '/'
+
+ function resolveUrl(url: string): string {
+ if (!url) return url
+ if (/^(https?:|#|mailto:|\/|data:)/.test(url)) return url
+ // Strip .md extension (+ optional anchor)
+ url = url.replace(/\.md(#.*)?$/, (_, anchor) => anchor ?? '')
+ // Strip README reference — resolves to the directory index
+ url = url.replace(/README(#.*)?$/, (_, anchor) => anchor ?? '.')
+ const anchor = url.match(/#.*/)?.[0] ?? ''
+ const pathPart = url.replace(/#.*$/, '')
+ const resolved = posixResolve(baseDir, pathPart)
+ return resolved + anchor
+ }
+
+ visit(tree, 'image', (node: any) => {
+ node.url = resolveUrl(node.url)
+ })
+
+ visit(tree, 'link', (node: any) => {
+ node.url = resolveUrl(node.url)
+ })
+
+ // Resolve src in raw HTML
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+