feat: serve raw markdown via .md URLs

.gitignore

@@ -48,3 +48,6 @@ netlify
 
 public/sitemap.xml
 public/i18n-status
+
+# Generated raw markdown files (from serveRawMarkdown vite plugin)
+public/**/*.md

app.config.ts

@@ -2,6 +2,9 @@ import { defineConfig } from "@solidjs/start/config";
 
 import { createWithSolidBase, defineTheme } from "@kobalte/solidbase/config";
 
+import type { ViteDevServer } from "vite";
+import type { IncomingMessage, ServerResponse } from "node:http";
+
 import tree from "./.solid/tree";
 import entries from "./.solid/flat-entries";
 import solidstartEntries from "./.solid/solid-start-flat-entries";
@@ -58,7 +61,7 @@ export default defineConfig(
 				},
 			},
 			vite: {
-				plugins: [docsData(), heroCodeSnippet()],
+				plugins: [docsData(), heroCodeSnippet(), serveRawMarkdown()],
 			},
 		},
 		{
@@ -145,8 +148,55 @@ export default defineConfig(
 );
 
 import { readFile } from "node:fs/promises";
+import { readFileSync, writeFileSync, mkdirSync, readdirSync } from "node:fs";
+import { join, relative, dirname, resolve } from "node:path";
 import { codeToHtml } from "shiki";
 
+function serveRawMarkdown() {
+	const srcDir = resolve("src/routes");
+	const publicDir = resolve("public");
+
+	function findMdxFiles(dir: string): string[] {
+		const results: string[] = [];
+		for (const entry of readdirSync(dir, { withFileTypes: true })) {
+			const fullPath = join(dir, entry.name);
+			if (entry.isDirectory()) {
+				results.push(...findMdxFiles(fullPath));
+			} else if (entry.name.endsWith(".mdx")) {
+				results.push(fullPath);
+			}
+		}
+		return results;
+	}
+
+	return {
+		name: "serve-raw-markdown",
+		configureServer(server: ViteDevServer) {
+			server.middlewares.use(
+				(req: IncomingMessage, res: ServerResponse, next: () => void) => {
+					if (!req.url?.endsWith(".md")) return next();
+					const mdxPath = join(srcDir, req.url.replace(/\.md$/, ".mdx"));
+					try {
+						const content = readFileSync(mdxPath, "utf-8");
+						res.setHeader("Content-Type", "text/plain; charset=utf-8");
+						res.end(content);
+					} catch {
+						next();
+					}
+				}
+			);
+		},
+		buildStart() {
+			for (const file of findMdxFiles(srcDir)) {
+				const rel = relative(srcDir, file).replace(/\.mdx$/, ".md");
+				const dest = join(publicDir, rel);
+				mkdirSync(dirname(dest), { recursive: true });
+				writeFileSync(dest, readFileSync(file, "utf-8"));
+			}
+		},
+	};
+}
+
 function heroCodeSnippet() {
 	const virtualModuleId = "solid:hero-code-snippet";
 	const resolveVirtualModuleId = "\0" + virtualModuleId;