feat: add raw markdown endpoint and Copy as Markdown button

app/docs-raw/[...slug]/route.dev.ts

@@ -0,0 +1,21 @@
+import { getDoc } from "@/lib/docs"
+import { parseDocSlug } from "@/lib/docs-config"
+
+// In production, .md files are served as static files written by scripts/copy-docs-md.ts.
+// This route only runs in dev (output: "export" is not set in dev).
+export const dynamic = "force-dynamic"
+
+export async function GET(
+  _request: Request,
+  { params }: { params: Promise<{ slug: string[] }> }
+) {
+  const { slug } = await params
+  const { version, docSlug } = parseDocSlug(slug)
+  const doc = getDoc(version, docSlug)
+
+  if (!doc) return new Response("Not found", { status: 404 })
+
+  return new Response(doc.content, {
+    headers: { "Content-Type": "text/markdown; charset=utf-8" },
+  })
+}

app/docs/[...slug]/page.tsx

@@ -104,7 +104,7 @@ export default async function DocPage({ params }: PageProps) {
       {/* Table of Contents - right sidebar */}
       {headings.length > 0 && (
         <aside className="sticky top-14 hidden h-[calc(100vh-3.5rem)] w-56 shrink-0 overflow-y-auto py-8 pr-4 xl:block">
-          <TableOfContents headings={headings} />
+          <TableOfContents headings={headings} rawContent={doc.content} />
         </aside>
       )}
     </div>

components/table-of-contents.tsx

@@ -2,15 +2,30 @@
 
 import { useEffect, useState } from "react"
 import { cn } from "@/lib/utils"
+import { CopyIcon, CheckIcon } from "lucide-react"
 
 interface TocEntry {
   depth: number
   text: string
   id: string
 }
 
-export function TableOfContents({ headings }: { headings: TocEntry[] }) {
+export function TableOfContents({
+  headings,
+  rawContent,
+}: {
+  headings: TocEntry[]
+  rawContent?: string
+}) {
   const [activeId, setActiveId] = useState<string>("")
+  const [copied, setCopied] = useState(false)
+
+  async function copyMarkdown() {
+    if (!rawContent) return
+    await navigator.clipboard.writeText(rawContent)
+    setCopied(true)
+    setTimeout(() => setCopied(false), 2000)
+  }
 
   useEffect(() => {
     if (headings.length === 0) return
@@ -46,6 +61,19 @@ export function TableOfContents({ headings }: { headings: TocEntry[] }) {
 
   return (
     <nav aria-label="Table of contents">
+      {rawContent && (
+        <button
+          onClick={copyMarkdown}
+          className="mb-4 flex w-full items-center gap-1.5 text-sm text-muted-foreground transition-colors hover:text-foreground"
+        >
+          {copied ? (
+            <CheckIcon className="size-3.5 text-green-500" />
+          ) : (
+            <CopyIcon className="size-3.5" />
+          )}
+          {copied ? "Copied!" : "Copy as Markdown"}
+        </button>
+      )}
       <p className="mb-3 text-sm font-medium">On this page</p>
       <ul className="space-y-1.5 text-sm">
         {headings.map((heading) => (

next.config.mjs

@@ -1,9 +1,22 @@
 /** @type {import('next').NextConfig} */
+const isDev = process.env.NODE_ENV === "development"
+
 const nextConfig = {
-  output: "export",
+  output: isDev ? undefined : "export",
+  pageExtensions: isDev
+    ? ["tsx", "ts", "jsx", "js", "dev.ts", "dev.tsx"]
+    : ["tsx", "ts", "jsx", "js"],
   images: {
     unoptimized: true,
   },
+  async rewrites() {
+    return [
+      {
+        source: "/docs/:path*.md",
+        destination: "/docs-raw/:path*",
+      },
+    ]
+  },
 }
 
 export default nextConfig

package.json

@@ -5,7 +5,7 @@
   "private": true,
   "scripts": {
     "dev": "next dev --turbopack",
-    "build": "next build && bun run scripts/generate-rss.ts",
+    "build": "next build && bun run scripts/generate-rss.ts && bun run scripts/copy-docs-md.ts",
     "start": "next start",
     "lint": "eslint",
     "format": "prettier --write \"**/*.{ts,tsx}\"",

scripts/copy-docs-md.ts

@@ -0,0 +1,47 @@
+import fs from "fs"
+import path from "path"
+import matter from "gray-matter"
+import { VERSIONS, DEFAULT_VERSION, type Version } from "../lib/docs-config"
+
+const CONTENT_DIR = path.join(process.cwd(), "content/docs")
+const OUT_DIR = path.join(process.cwd(), "out/docs")
+
+function copyMarkdownFiles() {
+  let count = 0
+
+  for (const version of VERSIONS) {
+    const versionDir = path.join(CONTENT_DIR, version)
+    if (!fs.existsSync(versionDir)) continue
+
+    const targetDir =
+      version === DEFAULT_VERSION ? OUT_DIR : path.join(OUT_DIR, version)
+
+    function walk(dir: string, relativePath: string = "") {
+      const entries = fs.readdirSync(dir, { withFileTypes: true })
+
+      for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name)
+
+        if (entry.isDirectory()) {
+          walk(fullPath, path.join(relativePath, entry.name))
+        } else if (entry.name.endsWith(".mdx") || entry.name.endsWith(".md")) {
+          const rawContent = fs.readFileSync(fullPath, "utf-8")
+          const { content } = matter(rawContent)
+
+          const mdName = entry.name.replace(/\.(mdx|md)$/, ".md")
+          const outPath = path.join(targetDir, relativePath, mdName)
+
+          fs.mkdirSync(path.dirname(outPath), { recursive: true })
+          fs.writeFileSync(outPath, content.trim() + "\n")
+          count++
+        }
+      }
+    }
+
+    walk(versionDir)
+  }
+
+  console.log(`Copied ${count} markdown files → out/docs/`)
+}
+
+copyMarkdownFiles()