🤖 fix: prevent mdBook from parsing HTML as markdown

- Remove newlines from generated HTML to make it single-line
- mdBook treats multi-line content as markdown, inserting <p> tags
- Single-line HTML is passed through unchanged
- Fixes HTML corruption in extension overview page

Author: ammar-agent

scripts/mdbook-shiki.ts

@@ -64,6 +64,7 @@ function generateGridHtml(shikiHtml: string, originalCode: string): string {
 
 /**
  * Process markdown content to replace code blocks with highlighted HTML
+ * Wraps HTML in a special marker that mdBook won't process as markdown
  */
 async function processMarkdown(content: string, highlighter: Awaited<ReturnType<typeof createHighlighter>>): Promise<string> {
   // Match ```lang\ncode\n``` blocks
@@ -96,7 +97,12 @@ async function processMarkdown(content: string, highlighter: Awaited<ReturnType<
       });
 
       const gridHtml = generateGridHtml(html, code);
-      result = result.replace(fullMatch, gridHtml);
+      
+      // Remove newlines from HTML to prevent mdBook from treating it as markdown
+      // mdBook only parses multi-line content as markdown; single-line HTML is passed through
+      const singleLineHtml = gridHtml.replace(/\n/g, '');
+      
+      result = result.replace(fullMatch, singleLineHtml);
     } catch (error) {
       console.warn(`[mdbook-shiki] Failed to highlight code block (${lang}):`, error);
       // Keep original code block on error