md-pdf-studio 1.1.0

package/src/core/frontmatter.js

@@ -0,0 +1,54 @@
+/**
+ * Front Matter Parser Utility
+ */
+
+/**
+ * Parses YAML Front Matter from Markdown raw content
+ * @param {string} rawContent 
+ * @returns {{ data: Object, content: string }}
+ */
+function parseFrontMatter(rawContent = '') {
+  if (!rawContent || typeof rawContent !== 'string') {
+    return { data: {}, content: '' };
+  }
+
+  const frontMatterRegex = /^---\r?\n([\s\S]*?)\r?\n---\r?\n/;
+  const match = rawContent.match(frontMatterRegex);
+
+  if (!match) {
+    return { data: {}, content: rawContent };
+  }
+
+  const yamlBlock = match[1];
+  const content = rawContent.slice(match[0].length);
+  const data = {};
+
+  yamlBlock.split('\n').forEach(line => {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith('#')) return;
+
+    const colonIdx = trimmed.indexOf(':');
+    if (colonIdx === -1) return;
+
+    const key = trimmed.slice(0, colonIdx).trim();
+    let val = trimmed.slice(colonIdx + 1).trim();
+
+    // Remove quotes
+    if ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'"))) {
+      val = val.slice(1, -1);
+    }
+
+    // Convert booleans & numbers
+    if (val.toLowerCase() === 'true') val = true;
+    else if (val.toLowerCase() === 'false') val = false;
+    else if (!isNaN(val) && val !== '') val = Number(val);
+
+    data[key] = val;
+  });
+
+  return { data, content };
+}
+
+module.exports = {
+  parseFrontMatter
+};

package/src/core/index.js

@@ -0,0 +1,80 @@
+const fs = require('fs');
+const path = require('path');
+const { parseMarkdownToHtml } = require('./parser');
+const { renderHtmlToPdf } = require('../browser/renderer');
+const { resolvePath } = require('./utils');
+
+/**
+ * Main function to convert Markdown file to PDF
+ * @param {string} inputPath Path to source .md file
+ * @param {string} [outputPath] Path to target .pdf file
+ * @param {Object} [options] Conversion options
+ * @returns {Promise<{ htmlPath: string, pdfPath: string }>}
+ */
+async function convertMarkdownToPdf(inputPath, outputPath, options = {}) {
+  const absInputPath = resolvePath(inputPath);
+
+  if (!fs.existsSync(absInputPath)) {
+    throw new Error(`Input file not found: ${absInputPath}`);
+  }
+
+  const format = options.format ? options.format.toLowerCase() : 'pdf';
+
+  // Derive output path if omitted
+  let absOutputPath;
+  if (outputPath) {
+    absOutputPath = resolvePath(outputPath);
+  } else {
+    const parsed = path.parse(absInputPath);
+    absOutputPath = path.join(parsed.dir, `${parsed.name}.${format}`);
+  }
+
+  // Read Markdown
+  const markdownContent = fs.readFileSync(absInputPath, 'utf8');
+
+  // Parse to HTML
+  const htmlContent = parseMarkdownToHtml(markdownContent, options);
+
+  if (format === 'html') {
+    fs.writeFileSync(absOutputPath, htmlContent, 'utf8');
+    return {
+      htmlPath: absOutputPath,
+      pdfPath: null
+    };
+  }
+
+  // Temporary HTML path
+  const tempHtmlPath = path.join(path.parse(absOutputPath).dir, `_temp_${Date.now()}_${Math.random().toString(36).substring(7)}.html`);
+
+  try {
+    // Save temporary HTML file
+    fs.writeFileSync(tempHtmlPath, htmlContent, 'utf8');
+
+    // Render HTML to PDF via headless browser
+    await renderHtmlToPdf(tempHtmlPath, absOutputPath, options);
+
+    // Clean up temporary HTML file unless explicitly requested to keep
+    if (!options.keepHtml) {
+      if (fs.existsSync(tempHtmlPath)) {
+        fs.unlinkSync(tempHtmlPath);
+      }
+    }
+
+    return {
+      htmlPath: tempHtmlPath,
+      pdfPath: absOutputPath
+    };
+  } catch (error) {
+    // Clean up on failure
+    if (fs.existsSync(tempHtmlPath)) {
+      try { fs.unlinkSync(tempHtmlPath); } catch (_) {}
+    }
+    throw error;
+  }
+}
+
+module.exports = {
+  convertMarkdownToPdf,
+  parseMarkdownToHtml,
+  renderHtmlToPdf
+};

package/src/core/parser.js

@@ -0,0 +1,163 @@
+const { marked } = require('marked');
+const { 
+  parseFrontMatter, 
+  generateCoverPage, 
+  preprocessMarkdown, 
+  generateToc, 
+  readCustomCss, 
+  sanitizeHtml, 
+  escapeHtml 
+} = require('./utils');
+const { getHtmlTemplate } = require('./templates');
+
+/**
+ * Builds marked custom renderer for diagrams, UI mockups, and headings
+ * @param {Map<string, string>} headingsMap 
+ * @returns {marked.Renderer}
+ */
+function buildMarkedRenderer(headingsMap) {
+  const renderer = new marked.Renderer();
+  const originalCodeRenderer = renderer.code.bind(renderer);
+
+  renderer.code = function(codeArg, infostringArg, escapedArg) {
+    let text = '';
+    let lang = '';
+
+    if (typeof codeArg === 'object' && codeArg !== null) {
+      text = codeArg.text || '';
+      lang = codeArg.lang || '';
+    } else {
+      text = codeArg || '';
+      lang = infostringArg || '';
+    }
+
+    if (lang === 'mermaid') {
+      return `<div class="mermaid-container"><pre class="mermaid">${text}</pre></div>`;
+    }
+    
+    if (text.includes('┌') && text.includes('└')) {
+      return `<div class="ui-mockup-container"><pre class="ui-mockup"><code>${escapeHtml(text)}</code></pre></div>`;
+    }
+
+    return originalCodeRenderer.call(this, codeArg, infostringArg, escapedArg);
+  };
+
+  renderer.heading = function(text, level, raw, slugger) {
+    const rawClean = raw ? raw.trim() : text;
+    const slug = headingsMap.get(rawClean) || (slugger ? slugger.slug(raw) : `heading-${level}`);
+    return `<h${level} id="${slug}">${text}</h${level}>`;
+  };
+
+  return renderer;
+}
+
+/**
+ * Wraps section headers with section-group divs for clean page-break handling
+ * @param {string} html 
+ * @returns {string}
+ */
+function wrapSectionGroups(html) {
+  let wrapped = html.replace(
+    /<h3>(.*?)<\/h3>\s*(<div class="ui-mockup-container">|<table|<div class="mermaid-container">|<ul|<ol)/g, 
+    '<div class="section-group"><h3>$1</h3>$2'
+  );
+  return wrapped.replace(
+    /(<\/table>|<\/div>|<\/ul>|<\/ol>)\s*(?=<h[1-4]>|<hr|\$)/g, 
+    '$1</div>'
+  );
+}
+
+/**
+ * Converts Markdown content into a fully styled HTML string
+ * @param {string} rawMarkdownContent 
+ * @param {Object} options 
+ * @returns {string} HTML string
+ */
+function parseMarkdownToHtml(rawMarkdownContent, options = {}) {
+  // 1. Extract Front Matter & Metadata
+  const { data: frontMatter, content: markdownContent } = parseFrontMatter(rawMarkdownContent);
+  const titleMatch = markdownContent.match(/^#\s+(.+)$/m);
+  const title = frontMatter.title || options.title || (titleMatch ? titleMatch[1].trim() : 'Converted Document');
+  const subtitle = frontMatter.subtitle || options.subtitle || '';
+  const author = frontMatter.author || options.author || '';
+  const date = frontMatter.date || options.date || '';
+
+  // 2. Merge options
+  const mergedOptions = {
+    theme: options.theme || frontMatter.theme || 'modern',
+    font: options.font || frontMatter.font || 'Inter',
+    pageSize: options.pageSize || frontMatter.pageSize || 'A4',
+    orientation: options.orientation || frontMatter.orientation || (frontMatter.landscape ? 'landscape' : 'portrait'),
+    margin: options.margin || frontMatter.margin || '14mm 12mm 16mm 12mm',
+    toc: options.toc !== undefined ? options.toc : (frontMatter.toc || false),
+    cover: options.cover !== undefined ? options.cover : (frontMatter.cover || false),
+    header: options.header !== undefined ? options.header : (frontMatter.header || true),
+    footer: options.footer !== undefined ? options.footer : (frontMatter.footer || true),
+    mermaid: options.mermaid !== undefined ? options.mermaid : (frontMatter.mermaid !== false),
+    katex: options.katex !== undefined ? options.katex : (frontMatter.katex !== false),
+    customCss: options.customCss || '',
+    cssFile: options.cssFile || frontMatter.cssFile || frontMatter.css
+  };
+
+  // 3. Preprocess Markdown (LaTeX, pagebreaks, alerts)
+  const processedMd = preprocessMarkdown(markdownContent);
+
+  // 4. Generate TOC & Cover Page
+  let tocHtml = '';
+  let headingsMap = new Map();
+  if (mergedOptions.toc) {
+    const tocResult = generateToc(processedMd);
+    tocHtml = tocResult.tocHtml;
+    headingsMap = tocResult.headingsMap;
+  }
+
+  const coverHtml = generateCoverPage({
+    title,
+    subtitle,
+    author,
+    date,
+    cover: mergedOptions.cover
+  });
+
+  // 5. Read custom CSS file if specified
+  let customCss = mergedOptions.customCss || '';
+  if (mergedOptions.cssFile) {
+    customCss += '\n' + readCustomCss(mergedOptions.cssFile);
+  }
+
+  // 6. Parse Markdown using custom renderer
+  marked.setOptions({ gfm: true, breaks: true });
+  const renderer = buildMarkedRenderer(headingsMap);
+  marked.use({ renderer });
+
+  let bodyHtml = marked.parse(processedMd);
+  bodyHtml = sanitizeHtml(bodyHtml);
+
+  // 7. Inject TOC, Cover Page & Section Groups
+  if (tocHtml) {
+    bodyHtml = bodyHtml.includes('</h1>') 
+      ? bodyHtml.replace('</h1>', '</h1>\n' + tocHtml)
+      : tocHtml + bodyHtml;
+  }
+
+  if (coverHtml) {
+    bodyHtml = coverHtml + bodyHtml;
+  }
+
+  bodyHtml = wrapSectionGroups(bodyHtml);
+
+  // 8. Generate and return full HTML template
+  return getHtmlTemplate({
+    title,
+    author,
+    bodyHtml,
+    options: {
+      ...mergedOptions,
+      customCss
+    }
+  });
+}
+
+module.exports = {
+  parseMarkdownToHtml
+};

package/src/core/sanitizer.js

@@ -0,0 +1,35 @@
+/**
+ * HTML Sanitizer & Escaping Utilities
+ */
+
+/**
+ * Sanitizes HTML content by stripping dangerous inline script tags and inline handlers
+ * @param {string} html 
+ * @returns {string} Clean HTML string
+ */
+function sanitizeHtml(html) {
+  if (!html) return '';
+  return html
+    .replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '')
+    .replace(/\s*on\w+\s*=\s*(?:"[^"]*"|'[^']*'|[^\s>]+)/gi, '');
+}
+
+/**
+ * Escapes special HTML characters
+ * @param {string} str 
+ * @returns {string} Escaped string
+ */
+function escapeHtml(str) {
+  if (!str) return '';
+  return str
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#039;');
+}
+
+module.exports = {
+  sanitizeHtml,
+  escapeHtml
+};

package/src/core/templates.js

@@ -0,0 +1,192 @@
+const { getThemeStyles } = require('./themes');
+
+/**
+ * Escapes special XML characters in title/metadata
+ * @param {string} str 
+ * @returns {string}
+ */
+function escapeXml(str) {
+  if (!str) return 'Document';
+  return str.replace(/[<>&'"]/g, '');
+}
+
+/**
+ * Returns complete HTML document template with injected body, CSS, fonts, and scripts
+ * @param {Object} params
+ * @param {string} params.title Document title
+ * @param {string} [params.author] Document author
+ * @param {string} params.bodyHtml Document body HTML
+ * @param {Object} [params.options] Template options
+ * @returns {string} Full HTML string
+ */
+function getHtmlTemplate({ title, author = '', bodyHtml, options = {} }) {
+  const theme = options.theme || 'modern';
+  const enableMermaid = options.mermaid !== false;
+  const enableKatex = options.katex !== false;
+  const pageSize = options.pageSize || 'A4';
+  const orientation = options.orientation || 'portrait';
+  const margin = options.margin || '14mm 12mm 16mm 12mm';
+  const customCss = options.customCss || '';
+
+  const themeStyles = getThemeStyles(theme, options.font);
+
+  return `<!DOCTYPE html>
+<html lang="vi">
+<head>
+  <meta charset="UTF-8">
+  <title>${escapeXml(title)}</title>
+  
+  <!-- 
+    Google Fonts Integration - Verified Open Source Licensing:
+    - Inter: SIL Open Font License 1.1 (100% Free / Open Source)
+    - Roboto: Apache License 2.0 (100% Free / Open Source)
+    - JetBrains Mono: SIL Open Font License 1.1 (100% Free / Open Source)
+    - Fira Code: SIL Open Font License 1.1 (100% Free / Open Source)
+    - Merriweather: SIL Open Font License 1.1 (100% Free / Open Source)
+    - Lora: SIL Open Font License 1.1 (100% Free / Open Source)
+    - Noto Sans JP: SIL Open Font License 1.1 (100% Free / Open Source)
+  -->
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link href="https://fonts.googleapis.com/css2?family=Fira+Code:wght@400;500&family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&family=Lora:ital,wght@0,400;0,600;1,400&family=Merriweather:wght@400;700&family=Noto+Sans+JP:wght@400;500;700&family=Roboto:wght@400;500;700&display=swap" rel="stylesheet">
+  
+  ${enableKatex ? `
+  <!-- KaTeX for math rendering -->
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.16.8/dist/katex.min.css">
+  <script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.8/dist/katex.min.js"></script>
+  <script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.8/dist/contrib/auto-render.min.js" onload="if(typeof renderMathInElement==='function'){renderMathInElement(document.body);}"></script>
+  ` : ''}
+
+  ${enableMermaid ? `
+  <!-- Mermaid.js for diagrams -->
+  <script src="https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.min.js"></script>
+  <script>
+    document.addEventListener("DOMContentLoaded", function() {
+      if (typeof mermaid !== 'undefined') {
+        mermaid.initialize({
+          startOnLoad: true,
+          theme: '${theme === 'dark' ? 'dark' : 'base'}',
+          securityLevel: 'loose',
+          wrap: true,
+          useMaxWidth: true,
+          fontFamily: 'Inter, sans-serif',
+          sequence: {
+            useMaxWidth: true,
+            wrap: true,
+            boxMargin: 10,
+            noteMargin: 10,
+            messageMargin: 35
+          }
+        });
+      }
+    });
+  </script>
+  ` : ''}
+
+  <style>
+    @page {
+      size: ${pageSize} ${orientation};
+      margin: ${margin};
+    }
+
+    body {
+      -webkit-print-color-adjust: exact !important;
+      print-color-adjust: exact !important;
+    }
+
+    .page-break {
+      break-after: page;
+      page-break-after: always;
+    }
+
+    img {
+      max-width: 100% !important;
+      height: auto !important;
+      object-fit: contain;
+    }
+
+    input[type="checkbox"] {
+      -webkit-appearance: checkbox !important;
+      appearance: checkbox !important;
+      display: inline-block !important;
+      width: 14px !important;
+      height: 14px !important;
+      margin: 0 4px 0 0 !important;
+      vertical-align: middle !important;
+    }
+
+    ${themeStyles}
+
+    /* Table of Contents Container & Dotted Leader Lines */
+    .toc-container {
+      background: #f8fafc;
+      border: 1px solid #e2e8f0;
+      border-left: 4px solid #2563eb;
+      border-radius: 6px;
+      padding: 14px 18px;
+      margin: 16px 0 24px 0;
+      break-inside: avoid-page;
+      page-break-inside: avoid;
+    }
+
+    .toc-title {
+      font-size: 15px;
+      font-weight: 700;
+      color: #1e3a8a;
+      margin-bottom: 10px;
+      border-bottom: 1px solid #cbd5e1;
+      padding-bottom: 6px;
+    }
+
+    .toc-list {
+      list-style: none;
+      padding-left: 0;
+      margin: 0;
+    }
+
+    .toc-list li {
+      margin-bottom: 6px;
+      font-size: 13px;
+    }
+
+    .toc-list a {
+      display: flex;
+      align-items: baseline;
+      color: #2563eb;
+      text-decoration: none;
+    }
+
+    .toc-item-title {
+      flex-shrink: 0;
+      max-width: 80%;
+    }
+
+    .toc-item-dots {
+      flex-grow: 1;
+      border-bottom: 1px dotted #94a3b8;
+      margin: 0 8px;
+      align-self: center;
+    }
+
+    .toc-list a:hover {
+      text-decoration: underline;
+    }
+
+    .toc-item-h1 { font-weight: 600; padding-left: 0; }
+    .toc-item-h2 { padding-left: 16px; }
+    .toc-item-h3 { padding-left: 32px; font-size: 12px; color: #64748b; }
+
+    /* Custom Injected CSS */
+    ${customCss}
+  </style>
+</head>
+<body>
+  ${bodyHtml}
+</body>
+</html>`;
+}
+
+module.exports = {
+  getHtmlTemplate,
+  getThemeStyles
+};

package/src/core/themes/academic.js

@@ -0,0 +1,20 @@
+/**
+ * Academic Theme Styles
+ */
+module.exports = `
+  body { font-family: 'Merriweather', Georgia, serif; font-size: 12px; line-height: 1.7; color: #111827; background-color: #ffffff; padding: 10px; }
+  h1 { font-size: 20px; color: #111827; border-bottom: 2px solid #111827; padding-bottom: 6px; break-after: avoid-page; font-weight: 700; text-align: center; }
+  h2 { font-size: 15px; color: #1f2937; border-bottom: 1px solid #d1d5db; padding-bottom: 4px; margin-top: 20px; break-after: avoid-page; }
+  h3 { font-size: 13.5px; color: #374151; font-style: italic; break-after: avoid-page; }
+  blockquote { font-style: italic; border-left: 3px solid #6b7280; padding-left: 14px; margin: 12px 0; color: #4b5563; }
+  table { width: 100%; border-collapse: collapse; margin: 14px 0; font-size: 11.5px; }
+  tr { break-inside: avoid-page; }
+  th { background: #f3f4f6; color: #111827; padding: 6px; border: 1px solid #9ca3af; font-weight: 700; }
+  td { padding: 6px; border: 1px solid #d1d5db; }
+  code { font-family: 'JetBrains Mono', monospace; font-size: 11px; background: #f3f4f6; padding: 2px 4px; border-radius: 2px; }
+  pre { font-family: 'JetBrains Mono', monospace; font-size: 10px; background: #f9fafb; border: 1px solid #e5e7eb; padding: 10px; border-radius: 4px; break-inside: avoid-page; }
+  .formula-box { background: #f9fafb; border: 1px solid #d1d5db; padding: 8px 14px; border-radius: 4px; text-align: center; font-style: italic; }
+  .mermaid-container { display: block; text-align: center; margin: 14px 0; background: #ffffff; padding: 8px; border: 1px solid #e5e7eb; overflow-x: auto; break-inside: avoid-page; }
+  .mermaid { display: block; text-align: center; width: 100%; }
+  .mermaid svg { max-width: 100% !important; height: auto !important; margin: 0 auto; display: inline-block; }
+`;

package/src/core/themes/cover.js

@@ -0,0 +1,14 @@
+/**
+ * Cover Page CSS Styles
+ */
+module.exports = `
+  .cover-page { min-height: 85vh; display: flex; flex-direction: column; justify-content: center; align-items: center; text-align: center; padding: 40px 20px; break-after: page; page-break-after: always; }
+  .cover-page-inner { max-width: 650px; width: 100%; border: 2px solid #2563eb; padding: 40px 30px; border-radius: 8px; background: #ffffff; box-shadow: 0 10px 25px rgba(0,0,0,0.05); }
+  .cover-badge { display: inline-block; font-size: 11px; font-weight: 700; letter-spacing: 1.5px; color: #2563eb; background: #eff6ff; padding: 4px 12px; border-radius: 20px; margin-bottom: 20px; }
+  .cover-title { font-size: 28px !important; font-weight: 800 !important; color: #0f172a !important; line-height: 1.3 !important; margin-bottom: 12px !important; border: none !important; padding: 0 !important; text-transform: none !important; }
+  .cover-subtitle { font-size: 16px !important; font-weight: 500 !important; color: #475569 !important; margin-bottom: 24px !important; border: none !important; background: none !important; padding: 0 !important; }
+  .cover-divider { height: 3px; width: 80px; background: linear-gradient(90deg, #2563eb, #38bdf8); margin: 0 auto 24px auto; border-radius: 2px; }
+  .cover-meta-container { display: flex; flex-direction: column; gap: 8px; font-size: 13px; color: #64748b; align-items: center; }
+  .cover-meta-item { display: flex; gap: 8px; }
+  .cover-meta-label { font-weight: 600; color: #334155; }
+`;

package/src/core/themes/cyberpunk.js

@@ -0,0 +1,21 @@
+/**
+ * Cyberpunk Theme Styles
+ */
+module.exports = `
+  body { font-family: 'Fira Code', 'JetBrains Mono', monospace; font-size: 12.5px; line-height: 1.6; color: #00f0ff; background-color: #0d1117; padding: 10px; }
+  h1 { font-size: 21px; color: #ff007f; text-shadow: 0 0 5px rgba(255,0,127,0.5); border-bottom: 2px solid #ff007f; padding-bottom: 6px; break-after: avoid-page; text-transform: uppercase; }
+  h2 { font-size: 16px; color: #00f0ff; background: #161b22; border-left: 4px solid #00f0ff; padding: 6px 12px; break-after: avoid-page; }
+  h3 { font-size: 14px; color: #ffe600; border-bottom: 1px solid #30363d; padding-bottom: 4px; break-after: avoid-page; }
+  blockquote { background: #161b22; border-left: 4px solid #ff007f; color: #8b949e; padding: 10px 16px; }
+  table { width: 100%; border-collapse: collapse; margin: 12px 0; font-size: 11.5px; }
+  tr { break-inside: avoid-page; }
+  th { background: #161b22; color: #00f0ff; padding: 8px; border: 1px solid #30363d; }
+  td { padding: 7px; border: 1px solid #30363d; color: #c9d1d9; }
+  tbody tr:nth-child(even) { background: #161b22; }
+  code { font-family: 'Fira Code', monospace; font-size: 11px; background: #161b22; color: #ff007f; padding: 2px 6px; border: 1px solid #30363d; }
+  pre { font-family: 'Fira Code', monospace; font-size: 10px; background: #010409; color: #00f0ff; padding: 12px; border-radius: 4px; border: 1px solid #30363d; overflow-x: auto; break-inside: avoid-page; }
+  .formula-box { background: #161b22; border: 1px solid #00f0ff; padding: 10px; text-align: center; color: #00f0ff; }
+  .mermaid-container { display: block; text-align: center; margin: 14px 0; background: #161b22; padding: 10px; border: 1px solid #ff007f; border-radius: 4px; overflow-x: auto; break-inside: avoid-page; }
+  .mermaid { display: block; text-align: center; width: 100%; }
+  .mermaid svg { max-width: 100% !important; height: auto !important; margin: 0 auto; display: inline-block; }
+`;

package/src/core/themes/dark.js

@@ -0,0 +1,21 @@
+/**
+ * Dark Theme Styles
+ */
+module.exports = `
+  body { font-family: 'Inter', sans-serif; font-size: 13px; line-height: 1.6; color: #e2e8f0; background-color: #0f172a; padding: 10px; }
+  h1 { font-size: 21px; color: #f8fafc; border-bottom: 3px solid #38bdf8; padding-bottom: 8px; break-after: avoid-page; }
+  h2 { font-size: 16px; color: #38bdf8; background: #1e293b; border-left: 5px solid #38bdf8; padding: 6px 12px; border-radius: 0 4px 4px 0; break-after: avoid-page; }
+  h3 { font-size: 14.5px; color: #7dd3fc; border-bottom: 1px solid #334155; padding-bottom: 4px; break-after: avoid-page; }
+  blockquote { background: #1e293b; border-left: 4px solid #38bdf8; color: #cbd5e1; padding: 10px 16px; border-radius: 4px; }
+  table { width: 100%; border-collapse: collapse; margin: 12px 0; font-size: 12px; }
+  tr { break-inside: avoid-page; }
+  th { background: #1e293b; color: #38bdf8; padding: 8px; border: 1px solid #334155; }
+  td { padding: 7px; border: 1px solid #334155; }
+  tbody tr:nth-child(even) { background: #1e293b; }
+  code { font-family: 'JetBrains Mono', monospace; font-size: 11.5px; background: #1e293b; color: #f8fafc; padding: 2px 6px; border-radius: 3px; border: 1px solid #334155; }
+  pre { font-family: 'JetBrains Mono', monospace; font-size: 10.5px; background: #020617; color: #f8fafc; padding: 12px; border-radius: 6px; overflow-x: auto; break-inside: avoid-page; }
+  .formula-box { background: #1e293b; border: 1px solid #38bdf8; padding: 10px 16px; border-radius: 4px; text-align: center; color: #38bdf8; }
+  .mermaid-container { display: block; text-align: center; margin: 14px 0; background: #1e293b; padding: 12px; border-radius: 6px; overflow-x: auto; break-inside: avoid-page; }
+  .mermaid { display: block; text-align: center; width: 100%; }
+  .mermaid svg { max-width: 100% !important; height: auto !important; margin: 0 auto; display: inline-block; }
+`;

package/src/core/themes/ebook.js

@@ -0,0 +1,20 @@
+/**
+ * E-Book Theme Styles
+ */
+module.exports = `
+  body { font-family: 'Lora', Georgia, serif; font-size: 13.5px; line-height: 1.75; color: #2d3748; background: #fdfbf7; padding: 12px; }
+  h1 { font-size: 23px; font-weight: 700; color: #1a202c; text-align: center; margin-bottom: 20px; border-bottom: 2px solid #cbd5e0; padding-bottom: 8px; break-after: avoid-page; }
+  h2 { font-size: 17px; font-weight: 600; color: #2b6cb0; border-bottom: 1px solid #e2e8f0; padding-bottom: 4px; margin-top: 22px; break-after: avoid-page; }
+  h3 { font-size: 14.5px; font-weight: 600; color: #2c5282; font-style: italic; break-after: avoid-page; }
+  blockquote { font-style: italic; border-left: 3px solid #3182ce; background: #edf2f7; padding: 12px 18px; margin: 14px 0; border-radius: 0 4px 4px 0; }
+  table { width: 100%; border-collapse: collapse; margin: 14px 0; font-size: 12px; }
+  tr { break-inside: avoid-page; }
+  th { background: #ebf8ff; color: #2b6cb0; padding: 8px; border: 1px solid #bee3f8; }
+  td { padding: 7px; border: 1px solid #e2e8f0; }
+  code { font-family: 'JetBrains Mono', monospace; font-size: 11.5px; background: #edf2f7; color: #2d3748; padding: 2px 5px; border-radius: 3px; }
+  pre { font-family: 'JetBrains Mono', monospace; font-size: 10.5px; background: #2d3748; color: #f7fafc; padding: 12px; border-radius: 6px; overflow-x: auto; break-inside: avoid-page; }
+  .formula-box { background: #ebf8ff; border: 1px solid #bee3f8; padding: 10px; text-align: center; color: #2b6cb0; border-radius: 6px; }
+  .mermaid-container { display: block; text-align: center; margin: 14px 0; background: #ffffff; padding: 10px; border: 1px solid #e2e8f0; border-radius: 6px; overflow-x: auto; break-inside: avoid-page; }
+  .mermaid { display: block; text-align: center; width: 100%; }
+  .mermaid svg { max-width: 100% !important; height: auto !important; margin: 0 auto; display: inline-block; }
+`;

package/src/core/themes/github.js

@@ -0,0 +1,21 @@
+/**
+ * GitHub Theme Styles
+ */
+module.exports = `
+  body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif; font-size: 13px; line-height: 1.6; color: #1f2328; background: #ffffff; padding: 10px; }
+  h1 { font-size: 22px; font-weight: 600; color: #1f2328; border-bottom: 1px solid #d0d7de; padding-bottom: 8px; break-after: avoid-page; }
+  h2 { font-size: 17px; font-weight: 600; color: #1f2328; border-bottom: 1px solid #d0d7de; padding-bottom: 6px; margin-top: 20px; break-after: avoid-page; }
+  h3 { font-size: 14.5px; font-weight: 600; color: #1f2328; break-after: avoid-page; }
+  blockquote { border-left: 4px solid #d0d7de; color: #656d76; padding: 8px 16px; margin: 12px 0; }
+  table { width: 100%; border-collapse: collapse; margin: 12px 0; font-size: 12px; }
+  tr { break-inside: avoid-page; }
+  th { background: #f6f8fa; color: #1f2328; font-weight: 600; padding: 8px; border: 1px solid #d0d7de; }
+  td { padding: 7px; border: 1px solid #d0d7de; }
+  tbody tr:nth-child(even) { background: #f6f8fa; }
+  code { font-family: 'Fira Code', monospace; font-size: 11.5px; background: rgba(175,184,193,0.2); color: #1f2328; padding: 2px 5px; border-radius: 4px; }
+  pre { font-family: 'Fira Code', monospace; font-size: 10.5px; background: #f6f8fa; color: #1f2328; padding: 12px; border-radius: 6px; border: 1px solid #d0d7de; overflow-x: auto; break-inside: avoid-page; }
+  .formula-box { background: #f6f8fa; border: 1px solid #d0d7de; padding: 10px; text-align: center; border-radius: 6px; }
+  .mermaid-container { display: block; text-align: center; margin: 14px 0; background: #ffffff; padding: 8px; border: 1px solid #d0d7de; border-radius: 6px; overflow-x: auto; break-inside: avoid-page; }
+  .mermaid { display: block; text-align: center; width: 100%; }
+  .mermaid svg { max-width: 100% !important; height: auto !important; margin: 0 auto; display: inline-block; }
+`;