Create .md versions for documentation pages

Author: mstijak

homedocs/TODO.md

@@ -26,4 +26,4 @@
 [x] On this page should render closed on mobile
 [x] Move homedocs presets to cx-theme-variables
 [x] Make Stackblitz use cx-theme-variables
-[ ] Allow .md extension on each article
+[x] Allow .md extension on each article

homedocs/src/integrations/llms-txt/index.js

@@ -83,6 +83,19 @@ ${navIndex}`;
 
         await writeFile(join(distDir, "llms.txt"), indexContent, "utf-8");
         console.log("✅ llms.txt generated");
+
+        // Generate individual .md files for each doc page
+        let mdCount = 0;
+        for (const page of allPages) {
+          const mdxPath = join(srcDir, `${page.path}.mdx`);
+          try {
+            await access(mdxPath);
+            const content = await extractMdxContent(mdxPath, srcDir, false);
+            await writeFile(join(distDir, `${page.path}.md`), content, "utf-8");
+            mdCount++;
+          } catch {}
+        }
+        console.log(`✅ ${mdCount} individual .md files generated`);
       },
     },
   };
@@ -103,7 +116,7 @@ function generateNavigationIndex(site) {
       categoryLines.push(`\n#### ${group.title}`);
 
       for (const item of group.items) {
-        const url = `${site}/docs/${category.slug}/${item.slug}`;
+        const url = `${site}/docs/${category.slug}/${item.slug}.md`;
         const description = item.description ? `: ${item.description}` : "";
         categoryLines.push(`- [${item.title}](${url})${description}`);
       }
@@ -211,6 +224,12 @@ async function extractMdxContent(mdxPath, srcDir, onlyStructure) {
     );
   }
 
+  // Replace ImportPath component with code block (before import removal)
+  processedContent = processedContent.replace(
+    /<ImportPath\s+path="([^"]*)"\s*\/?>/g,
+    (_, path) => path ? "```ts\n" + path + "\n```" : "",
+  );
+
   // Remove import statements from MDX (but NOT from code blocks)
   // Split by code blocks, remove imports from non-code parts only
   const codeBlockRegex = /(```[\s\S]*?```)/g;

homedocs/src/layouts/DocsLayout.astro

@@ -16,9 +16,11 @@ interface Props {
 const { frontmatter, title: directTitle, description: directDescription } = Astro.props;
 const title = frontmatter?.title || directTitle || '';
 const description = frontmatter?.description || directDescription || '';
+const mdUrl = Astro.url.pathname.replace(/\/$/, '') + '.md';
 ---
 
 <BaseLayout title={`${title} - CxJS Documentation`} description={description}>
+    <link slot="head" rel="alternate" type="text/markdown" href={mdUrl} />
     <div class="min-h-screen bg-background">
       <Header />
 

homedocs/src/pages/docs/intro/ai.mdx

@@ -18,6 +18,8 @@ Following the [llms.txt](https://llmstxt.org/) standard, CxJS provides documenta
 | [llms-small.txt](/llms-small.txt) | Essential documentation (~100KB) | Fast context loading, basic usage |
 | [llms-full.txt](/llms-full.txt) | Complete documentation (~500KB) | Comprehensive reference, advanced features |
 
+Additionally, every documentation page is available as a `.md` file by replacing the URL path with `.md`. For example, this page is available at [`/docs/intro/ai.md`](/docs/intro/ai.md). The `llms.txt` index links to all individual `.md` pages.
+
 ### Usage with AI Assistants
 
 When working with AI coding assistants like Claude, ChatGPT, or Cursor, you can: