Finish serving md files for all doc pages

Author: fulopkovacs

app/routes/$libraryId/$version.docs.$.tsx

@@ -1,4 +1,4 @@
-import { createFileRoute } from '@tanstack/react-router'
+import { createFileRoute, redirect } from '@tanstack/react-router'
 import { seo } from '~/utils/seo'
 import { Doc } from '~/components/Doc'
 import { loadDocs } from '~/utils/docs'
@@ -11,6 +11,20 @@ export const Route = createFileRoute('/$libraryId/$version/docs/$')({
     const { _splat: docsPath, version, libraryId } = ctx.params
     const library = getLibrary(libraryId)
 
+    const isMarkdown = !!docsPath?.endsWith('.md')
+
+    if (isMarkdown) {
+      const href =
+        '/api/md' +
+        ctx.location.pathname.slice(
+          0,
+          ctx.location.pathname.length - '.md'.length
+        )
+      throw redirect({
+        href,
+      })
+    }
+
     return loadDocs({
       repo: library.repo,
       branch: getBranch(library, version),

app/routes/api/md/$libraryId/$version.docs.$.tsx

@@ -0,0 +1,38 @@
+import {  createAPIRoute } from '@tanstack/start/api'
+import { getBranch, getLibrary } from '~/libraries'
+import { loadDocs } from '~/utils/docs'
+
+export const APIRoute = createAPIRoute('/api/md/$libraryId/$version/docs/framework/$framework/$')({
+  GET: async ({ params, request }) => {
+    const { _splat: docsPath, version, libraryId } = params
+    const library = getLibrary(libraryId)
+
+    const location = new URL(request.url)
+
+    const loadDocsArgs = {
+      repo: library.repo,
+      branch: getBranch(library, version),
+      docsPath: `${library.docsRoot || 'docs'}/${docsPath}`,
+      currentPath: location.pathname.slice('/api/md'.length),
+      redirectPath: `/${library.id}/${version}/docs/overview.md`,
+      useServerFn: false
+    }
+
+    const res = await loadDocs(loadDocsArgs)
+
+    const { content, description, title} = res
+
+    // Generate or fetch the Markdown content dynamically
+    const markdownContent = `# ${title}\n\n> ${description}\n\n${content}`
+
+    const filename = (docsPath || 'file').split('/').join('-')
+
+    // Return the Markdown content as a response
+    return new Response(markdownContent, {
+      headers: {
+        'Content-Type': 'text/markdown',
+        'Content-Disposition': `inline; filename="${filename}.md"`,
+      },
+    })
+  },
+})

app/routes/api/md/$libraryId/$version.docs.framework.$framework.$.ts

@@ -16,7 +16,7 @@ export const APIRoute = createAPIRoute('/api/md/$libraryId/$version/docs/framewo
         library.docsRoot || 'docs'
       }/framework/${framework}/${docsPath}`,
       currentPath: location.pathname.slice('/api/md'.length),
-      redirectPath: `/${library.id}/${version}/docs/overview`,
+      redirectPath: `/${library.id}/${version}/docs/overview.md`,
       useServerFn: false
     }