@knowcode/doc-builder 1.10.5 → 1.10.7

package/assets/css/notion-style.css

@@ -605,19 +605,19 @@ pre code {
 }
 
 .nav-section[data-level="1"] {
-  margin-left: var(--space-4);
+  margin-left: var(--space-2);
   margin-bottom: var(--space-0-5);
 }
 
 .nav-section[data-level="2"] {
-  margin-left: var(--space-8);
+  margin-left: var(--space-4);
   margin-bottom: var(--space-0-5);
 }
 
 .nav-title {
   display: flex;
   align-items: center;
-  padding: var(--space-1-5) var(--space-3);
+  padding: var(--space-0-5) var(--space-3);
   font-size: var(--text-sm);
   font-weight: var(--font-medium);
   color: var(--color-text-secondary);
@@ -629,11 +629,11 @@ pre code {
 
 /* Indent nav titles based on their level */
 .nav-section[data-level="1"] .nav-title {
-  padding-left: calc(var(--space-3) + var(--space-4));
+  padding-left: calc(var(--space-3) + var(--space-2));
 }
 
 .nav-section[data-level="2"] .nav-title {
-  padding-left: calc(var(--space-3) + var(--space-8));
+  padding-left: calc(var(--space-3) + var(--space-4));
 }
 
 .nav-title:hover {
@@ -668,27 +668,27 @@ pre code {
 .nav-item {
   display: flex;
   align-items: center;
-  padding: var(--space-1-5) var(--space-3);
+  padding: var(--space-0-5) var(--space-3);
   font-size: var(--text-sm);
   color: var(--color-text-primary);
   text-decoration: none;
   border-radius: var(--radius-md);
   transition: all var(--duration-fast) var(--easing-out);
   margin-bottom: 0;
-  gap: var(--space-2);
+  gap: var(--space-1);
 }
 
 /* Indent nav items based on their parent section level */
 .nav-section[data-level="0"] .nav-item {
-  padding-left: calc(var(--space-3) + var(--space-6));
+  padding-left: calc(var(--space-3) + var(--space-3));
 }
 
 .nav-section[data-level="1"] .nav-item {
-  padding-left: calc(var(--space-3) + var(--space-10));
+  padding-left: calc(var(--space-3) + var(--space-5));
 }
 
 .nav-section[data-level="2"] .nav-item {
-  padding-left: calc(var(--space-3) + var(--space-12));
+  padding-left: calc(var(--space-3) + var(--space-6));
 }
 
 .nav-item:hover {
@@ -1031,7 +1031,8 @@ tr:hover {
   white-space: nowrap;
 }
 
-/* PDF button in breadcrumbs */
+/* MD and PDF buttons in breadcrumbs */
+.breadcrumb-md-btn,
 .breadcrumb-pdf-btn {
   background: none;
   border: none;
@@ -1043,6 +1044,7 @@ tr:hover {
   font-size: 1rem;
 }
 
+.breadcrumb-md-btn:hover,
 .breadcrumb-pdf-btn:hover {
   background: var(--color-bg-tertiary);
   color: var(--color-text-primary);
@@ -1979,8 +1981,8 @@ tr:hover {
 .nav-title {
   display: flex;
   align-items: center;
-  gap: var(--space-2);
-  padding: var(--space-2);
+  gap: var(--space-1);
+  padding: var(--space-1);
   color: var(--color-text-primary);
   text-decoration: none;
   font-size: var(--text-sm);
@@ -2029,14 +2031,14 @@ tr:hover {
 .nav-item {
   display: flex;
   align-items: center;
-  gap: var(--space-2);
-  padding: var(--space-1-5) var(--space-2);
+  gap: var(--space-1);
+  padding: var(--space-0-5) var(--space-2);
   color: var(--color-text-secondary);
   text-decoration: none;
   font-size: var(--text-sm);
   border-radius: var(--radius-md);
   transition: all var(--duration-fast);
-  margin-bottom: var(--space-0-5);
+  margin-bottom: 0;
 }
 
 .nav-item:hover {

package/assets/js/main.js

@@ -1296,6 +1296,31 @@ function initNavigationFilter() {
   });
 }
 
+// Markdown Download functionality
+function downloadMarkdown() {
+  // Get current page path and convert to .md
+  let currentPath = window.location.pathname;
+
+  // Handle different path formats
+  if (currentPath.endsWith('/')) {
+    currentPath += 'index.html';
+  }
+  if (!currentPath.endsWith('.html')) {
+    currentPath += '.html';
+  }
+
+  // Replace .html with .md
+  const mdPath = currentPath.replace(/\.html$/, '.md');
+
+  // Create a link and trigger download
+  const link = document.createElement('a');
+  link.href = mdPath;
+  link.download = mdPath.split('/').pop(); // Get filename
+  document.body.appendChild(link);
+  link.click();
+  document.body.removeChild(link);
+}
+
 // PDF Export functionality
 function exportToPDF() {
   // Hide UI elements for printing
@@ -1588,6 +1613,9 @@ function generateBreadcrumbs() {
         <div class="breadcrumbs-content breadcrumbs-homepage">
           <div class="breadcrumbs-right">
             <span class="breadcrumb-date" title="Built with doc-builder v${docBuilderVersion || ''}">Last updated: ${displayDate}</span>
+            <button class="breadcrumb-md-btn" onclick="downloadMarkdown()" title="Download Markdown" aria-label="Download Markdown">
+              <i class="fas fa-file-code"></i>
+            </button>
             <button class="breadcrumb-pdf-btn" onclick="exportToPDF()" title="Export to PDF" aria-label="Export to PDF">
               <i class="fas fa-file-pdf"></i>
             </button>
@@ -1605,6 +1633,9 @@ function generateBreadcrumbs() {
           </div>
           <div class="breadcrumbs-right">
             <span class="breadcrumb-date" title="Built with doc-builder v${docBuilderVersion || ''}">Last updated: ${displayDate}</span>
+            <button class="breadcrumb-md-btn" onclick="downloadMarkdown()" title="Download Markdown" aria-label="Download Markdown">
+              <i class="fas fa-file-code"></i>
+            </button>
             <button class="breadcrumb-pdf-btn" onclick="exportToPDF()" title="Export to PDF" aria-label="Export to PDF">
               <i class="fas fa-file-pdf"></i>
             </button>

package/lib/core-builder.js

@@ -349,21 +349,16 @@ function processMarkdownContent(content, config = {}) {
   
   // Parse the markdown
   let html = marked.parse(processedContent);
-
+  
   // Replace placeholders with actual mermaid blocks
   mermaidBlocks.forEach((block, index) => {
     html = html.replace(`<p>MERMAID_BLOCK_${index}</p>`, block);
     html = html.replace(`MERMAID_BLOCK_${index}`, block);
   });
-
-  // Convert internal .md links to .html links
-  // Matches href="...md" or href='...md' and converts to .html
-  // Handles: file.md, path/file.md, file.md#anchor, file.md?query
-  html = html.replace(/href=(["'])([^"']*?)\.md((?:#[^"']*)?(?:\?[^"']*)?)\1/gi, 'href=$1$2.html$3$1');
-
+  
   // Replace emojis with Phosphor icons if enabled
   html = replaceEmojisWithIcons(html, config);
-
+  
   return html;
 }
 
@@ -418,7 +413,12 @@ function generateHTML(title, content, navigation, currentPath = '', config = {},
   // Get doc-builder version from package.json
   const packageJson = require('../package.json');
   const docBuilderVersion = packageJson.version;
-  
+
+  // Extract source metadata if available
+  const sourceMetadata = config._sourceMetadata || {};
+  const sourcePath = sourceMetadata.sourcePath || '';
+  const generatedAt = sourceMetadata.generatedAt || new Date().toISOString();
+
   // SEO preparation
   let seoTags = '';
   let jsonLd = '';
@@ -503,7 +503,11 @@ function generateHTML(title, content, navigation, currentPath = '', config = {},
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <meta name="description" content="${escapeHtml(pageDescription || generateDescription(originalContent || content) || siteDescription)}">
     <title>${escapeHtml(finalSeoTitle || `${title} - ${siteName}`)}</title>
-    
+
+    <!-- Source metadata -->
+    ${sourcePath ? `<meta name="md-source" content="${escapeHtml(sourcePath)}">` : ''}
+    <meta name="doc-generated" content="${escapeHtml(generatedAt)}">
+
 ${seoTags}
     
     <!-- Fonts -->
@@ -796,6 +800,9 @@ ${seoTags}
                 minute: '2-digit',
                 timeZone: 'UTC'
             })} UTC</span>
+            <button class="breadcrumb-md-btn" onclick="downloadMarkdown()" title="Download Markdown" aria-label="Download Markdown">
+              <i class="fas fa-file-code"></i>
+            </button>
             <button class="breadcrumb-pdf-btn" onclick="if(typeof exportToPDF !== 'undefined') exportToPDF(); else window.print();" title="Export to PDF" aria-label="Export to PDF">
               <i class="fas fa-file-pdf"></i>
             </button>
@@ -838,6 +845,13 @@ ${seoTags}
         mermaidEnhanced: ${config.features?.mermaidEnhanced !== false}
       }
     };
+
+    // Source metadata for JS consumers
+    window.__DOC_SOURCE__ = {
+      mdSource: ${sourcePath ? `"${escapeHtml(sourcePath)}"` : 'null'},
+      generatedAt: "${escapeHtml(generatedAt)}",
+      docBuilderVersion: "${docBuilderVersion}"
+    };
     </script>
     <script src="${resourcePath}js/main.js"></script>
     ${(config.features?.authentication === 'supabase' || config.features?.privateDirectoryAuth === true) ? `<script src="https://unpkg.com/@supabase/supabase-js@2"></script>
@@ -1145,21 +1159,35 @@ async function processMarkdownFile(filePath, outputPath, allFiles, config, useSt
   
   // Process content
   const htmlContent = processMarkdownContent(content, config);
-  
+
+  // Create config with source metadata for HTML generation
+  const generationTimestamp = new Date().toISOString();
+  const htmlConfig = {
+    ...config,
+    _sourceMetadata: {
+      sourcePath: relativePath,  // e.g., "docs/technical/local-dev-troubleshooting.md"
+      generatedAt: generationTimestamp
+    }
+  };
+
   // Build navigation - pass config to handle private file filtering
   // For static HTML, we need to build navigation with relative paths
-  const navConfig = useStaticHTML ? { ...config, isStaticOutput: true } : config;
+  const navConfig = useStaticHTML ? { ...htmlConfig, isStaticOutput: true } : htmlConfig;
   const navigation = buildNavigationStructure(allFiles, urlPath, navConfig);
-  
+
   // Generate full HTML (pass original content and front matter for SEO)
-  const html = useStaticHTML 
-    ? generateStaticHTML(title, htmlContent, navigation, urlPath, config, content, frontMatter)
-    : generateHTML(title, htmlContent, navigation, urlPath, config, content, frontMatter);
+  const html = useStaticHTML
+    ? generateStaticHTML(title, htmlContent, navigation, urlPath, htmlConfig, content, frontMatter)
+    : generateHTML(title, htmlContent, navigation, urlPath, htmlConfig, content, frontMatter);
   
   // Write file
   await fs.ensureDir(path.dirname(outputPath));
   await fs.writeFile(outputPath, html);
-  
+
+  // Copy source .md file alongside HTML for download
+  const mdOutputPath = outputPath.replace(/\.html$/, '.md');
+  await fs.copyFile(filePath, mdOutputPath);
+
   return { title, urlPath, summary, frontMatter };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowcode/doc-builder",
-  "version": "1.10.5",
+  "version": "1.10.7",
   "description": "Reusable documentation builder for markdown-based sites with Vercel deployment support",
   "main": "index.js",
   "bin": {