@jiyeqian/md2pdf 1.4.0 → 1.5.0

package/README.md

@@ -3,7 +3,13 @@
 把 Markdown 排成**优雅的中文 A4 PDF**：报头大标题、元信息条、精心排过的表格/代码/引用/列表、页脚页码。
 不是 pandoc 的默认样式 —— 是可以直接拿去打印、发给别人看的版式。
 
-![themes](docs/themes.png)
+**elegant 主题**（默认，墨蓝 + 古铜）：
+
+![elegant 主题效果](docs/theme-elegant.png)
+
+**minimal 主题**（黑白公文风）：
+
+![minimal 主题效果](docs/theme-minimal.png)
 
 仓库：https://cnb.cool/jiyeqian/md2pdf
 
@@ -121,6 +127,7 @@ node ci/inspect-pdf.mjs out.pdf
 - 首个 H1 提升为报头大标题，正文不再重复；其后的首段自动成为导语。
 - YAML frontmatter 的 `name` / `description` 生成元信息条；description 里「适用于…」「不用于…」会自动拆成「适用 / 不适用」两栏。
 - H2 自动分节并加色块标记；表格深色表头＋隔行浅底；有序列表用圆形序号。
+- 数学公式：正文里的 `$...$`（行内）与 `$$...$$`（独立成行）由内置 MathJax 渲染（SVG 输出，零字体依赖）。
 - 相对路径图片自动解析成绝对地址，能正常进入 PDF。
 
 ## 改样式
@@ -220,4 +227,4 @@ skill/SKILL.md          Agent 技能说明书（postinstall 会装到技能目
 
 MIT
 
-第三方组件：`vendor/marked.esm.js` 来自 [marked](https://github.com/markedjs/marked)（MIT License），随仓库分发以便零依赖安装。
+第三方组件：`vendor/marked.esm.js` 来自 [marked](https://github.com/markedjs/marked)（MIT License）；`vendor/mathjax/tex-svg.js` 来自 [MathJax](https://github.com/mathjax/MathJax)（Apache-2.0 License）。均随仓库分发以便零依赖安装。

package/assets/shell.html

@@ -27,5 +27,7 @@
   <span>{{COLOPHON_RIGHT}}</span>
 </div>
 
+{{MATHJAX}}
+
 </body>
 </html>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jiyeqian/md2pdf",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "把 Markdown 排成优雅的中文 A4 PDF（无头 Chrome 渲染，带报头、表格/代码排版与页脚页码）",
   "type": "module",
   "bin": {

package/src/md2pdf.mjs

@@ -40,7 +40,7 @@ import { fileURLToPath, pathToFileURL } from 'node:url';
 const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
 const ASSETS = path.join(ROOT, 'assets');
 
-const VERSION = '1.4.0';
+const VERSION = '1.5.0';
 
 // Node ≥ 22 有全局 WebSocket；更老的版本退回到内置的极简实现
 let _WS;
@@ -293,6 +293,19 @@ class Chrome {
     await this.send('Page.navigate', { url: pathToFileURL(htmlPath).href });
     await loaded;
     await new Promise(r => setTimeout(r, 250));
+    // MathJax 排版：正文含公式时，轮询等待 typeset 完成再打印（否则公式是空白）
+    if (opts.waitMath) {
+      const t0 = Date.now();
+      while (Date.now() - t0 < 10000) {
+        let done = false;
+        try {
+          const r = await this.send('Runtime.evaluate', { expression: 'window.__md2pdfMathReady === true', returnByValue: true });
+          done = !!(r && r.result && r.result.value);
+        } catch { /* 忽略运行时异常，继续等待 */ }
+        if (done) break;
+        await new Promise(r => setTimeout(r, 100));
+      }
+    }
     const base = {
       printBackground: true,
       preferCSSPageSize: true,
@@ -328,6 +341,9 @@ async function renderOne(mdPath, opts, chrome, marked, tmpRoot) {
   const { fm, body } = splitFrontmatter(src);
   const isSkill = path.basename(mdPath) === 'SKILL.md' || !!fm.name;
 
+  // 数学公式：检测 $...$ 或 $...$，命中则注入 MathJax（SVG 输出，零字体依赖）
+  const hasMath = /\$\$|\$[^$\n]+\$/.test(body);
+
   let html = marked.parse(body, { gfm: true, breaks: false, async: false });
 
   // 标题：正文首个 H1 → 报头
@@ -406,6 +422,24 @@ async function renderOne(mdPath, opts, chrome, marked, tmpRoot) {
   const fill = (tpl, map) => Object.entries(map).reduce(
     (s, [k, v]) => s.split(k).join(v), tpl);
 
+  const mathUrl = pathToFileURL(path.join(ROOT, 'vendor', 'mathjax', 'tex-svg.js')).href;
+  const mathScript = hasMath ? [
+    '<script>',
+    'window.__md2pdfMathReady = false;',
+    'window.MathJax = {',
+    '  tex: { inlineMath: [["$", "$"]] },',
+    '  svg: { fontCache: "none" },',
+    '  startup: {',
+    '    ready: function () {',
+    '      MathJax.startup.defaultReady();',
+    '      MathJax.startup.promise.then(function () { window.__md2pdfMathReady = true; });',
+    '    }',
+    '  }',
+    '};',
+    '</script>',
+    '<script src="' + mathUrl + '" id="MathJax-script"></script>',
+  ].join('\n') : '';
+
   const shell = await readFile(path.join(ASSETS, 'shell.html'), 'utf8');
   const out = fill(shell, {
     '{{TITLE}}': esc(title),
@@ -417,6 +451,7 @@ async function renderOne(mdPath, opts, chrome, marked, tmpRoot) {
     '{{BODY}}': html,
     '{{COLOPHON_LEFT}}': esc(colophonLeft),
     '{{COLOPHON_RIGHT}}': esc(colophonRight),
+    '{{MATHJAX}}': mathScript,
   });
 
   if (opts.htmlOnly) return { title, html: out };
@@ -431,7 +466,7 @@ async function renderOne(mdPath, opts, chrome, marked, tmpRoot) {
       <span style="flex:1;text-align:right;">${opts.footerRight || ''}</span>
     </div>`;
 
-  const buf = await chrome.print(htmlPath, { footer: opts.footer, footerTemplate, landscape: opts.landscape, outline: opts.outline });
+  const buf = await chrome.print(htmlPath, { footer: opts.footer, footerTemplate, landscape: opts.landscape, outline: opts.outline, waitMath: hasMath });
 
   if (opts.keepHtml) {
     await writeFile(mdPath.replace(/\.md$/i, '.html'), out, 'utf8');