@knowcode/doc-builder 1.10.6 → 1.10.8

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

@@ -800,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>
@@ -1180,7 +1183,11 @@ async function processMarkdownFile(filePath, outputPath, allFiles, config, useSt
   // 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 };
 }
 
@@ -1189,6 +1196,7 @@ async function scanAllFiles(dir, baseDir = dir, options = {}) {
   const markdownFiles = [];
   const attachmentFiles = [];
   const attachmentTypes = options.attachmentTypes || [];
+  const excludeDirs = options.excludeDirs || [];
   const items = await fs.readdir(dir);
 
   for (const item of items) {
@@ -1201,6 +1209,11 @@ async function scanAllFiles(dir, baseDir = dir, options = {}) {
     const fullPath = path.join(dir, item);
     const stat = await fs.stat(fullPath);
 
+    // Skip excluded directories (output dirs, node_modules, .git, etc.)
+    if (stat.isDirectory() && excludeDirs.includes(item)) {
+      continue;
+    }
+
     // Skip private directories if excludePrivate is true
     if (stat.isDirectory() && options.excludePrivate && item === 'private') {
       continue;
@@ -1338,8 +1351,17 @@ async function buildDocumentation(config) {
     '.mp4', '.mp3', '.wav', '.avi', '.mov'
   ];
 
+  // Auto-exclude output directories and common non-doc directories
+  const excludeDirs = [
+    path.basename(config.outputDir),
+    path.basename(config.staticOutputDir || 'html-static'),
+    'node_modules',
+    '.git'
+  ];
+
   const { markdownFiles: files, attachmentFiles } = await scanAllFiles(docsDir, docsDir, {
-    attachmentTypes: config.features?.attachments !== false ? attachmentTypes : []
+    attachmentTypes: config.features?.attachments !== false ? attachmentTypes : [],
+    excludeDirs
   });
 
   console.log(chalk.green(`✅ Found ${files.length} markdown files${readmeGenerated ? ' (including auto-generated README)' : ''}`));

package/package.json

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