@jiyeqian/md2pdf 1.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dr. Qian
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,223 @@
+# md2pdf
+
+把 Markdown 排成**优雅的中文 A4 PDF**：报头大标题、元信息条、精心排过的表格/代码/引用/列表、页脚页码。
+不是 pandoc 的默认样式 —— 是可以直接拿去打印、发给别人看的版式。
+
+![themes](docs/themes.png)
+
+仓库：https://cnb.cool/jiyeqian/md2pdf
+
+## 两部分:命令 + 说明书
+
+这个工具是两层结构,各自独立存在、各自分发:
+
+| 层 | 是什么 | 给谁用 | 落在哪 |
+| --- | --- | --- | --- |
+| **命令** `md2pdf` | 真正的程序(Node + 无头 Chrome 渲染) | 你、任何脚本 | npm 全局安装到 `node_modules/@jiyeqian/md2pdf/` |
+| **技能说明书** `skill/SKILL.md` | 告诉 Agent「有 `md2pdf` 这个命令、怎么用」 | WorkBuddy 等 Agent 运行时 | `~/.workbuddy/skills/md-to-pdf/` |
+
+npm 的 `postinstall` 一次装两样:环境里有 WorkBuddy(`~/.workbuddy` 存在)就顺带装说明书,
+没有就只装命令。只要命令用 `MD2PDF_SKILL=0` 跳过。
+
+> 为什么说明书不在程序里?因为「怎么用」是给 Agent 看的,「能转换」是给系统跑的 ——
+> 混在一起会让换机器时多一份要同步的实现。说明书只有一份,就在仓库 `skill/`。
+
+## 安装
+
+**一条命令**（需要 Node ≥ 18，建议 ≥ 22）：
+
+```bash
+npm install -g @jiyeqian/md2pdf
+```
+
+它会装上 `md2pdf` 命令；`postinstall` 顺带把技能说明书装进 `~/.workbuddy`（存在时）。
+
+```bash
+md2pdf 你的文档.md --open   # 装完试一下
+```
+
+**更新**：`npm update -g @jiyeqian/md2pdf` · **卸载**：`npm uninstall -g @jiyeqian/md2pdf`
+
+| 变量 | 作用 |
+| --- | --- |
+| `MD2PDF_SKILL=0` | 安装时不装 Agent 技能说明书 |
+| `MD2PDF_SKILL_DIR=<dir>` | 说明书落点，默认 `~/.workbuddy/skills/md-to-pdf`（`~/.workbuddy` 不存在时默认不装） |
+
+### 在仓库里开发
+
+```bash
+git clone https://cnb.cool/jiyeqian/md2pdf.git
+cd md2pdf
+npm link             # 把 bin/md2pdf 软链进 PATH，指向仓库本身，改代码立即生效
+```
+
+`npm link` 之后命令就是仓库本身，改完立即生效，不需要重装。
+
+### 依赖
+
+| 依赖 | 要求 | 说明 |
+| --- | --- | --- |
+| Node.js | ≥ 18（建议 ≥ 22） | < 22 时自动启用内置 WebSocket 实现；`MD2PDF_NODE` 可指定 |
+| Chrome / Edge / Chromium | 任一 | 只用来渲染，不联网；`MD2PDF_CHROME` 可指定路径 |
+
+零 npm 依赖 —— Markdown 解析器（marked）已内置在 `vendor/`，装好即用。
+
+## 用法
+
+```bash
+md2pdf 文件名.md                    # 同目录输出同名 .pdf
+md2pdf 文件名.md --open             # 转完直接打开
+md2pdf a.md b.md -o 输出目录/       # 批量（共用一个浏览器实例，很快）
+md2pdf 文件名.md --theme minimal --toc
+```
+
+### 选项
+
+| 选项 | 作用 |
+| --- | --- |
+| `-o, --output <path>` | 输出路径；多文件或目标是目录时，作为输出目录 |
+| `--theme <name>` | `elegant`（默认，墨蓝＋古铜）｜ `minimal`（黑白公文风） |
+| `--title <text>` | 覆盖标题（默认：正文首个 H1 → frontmatter.title → 文件名） |
+| `--kicker <text>` | 报头小标题；`SKILL.md` 默认显示「技能文档」 |
+| `--no-meta` | 不要 frontmatter 元信息条 |
+| `--no-lead` | 首段不作为导语放大 |
+| `-t, --toc` | 文首插入目录页（取自 H2，需 2 个以上），每项可点击跳转 |
+| `--no-outline` | 不生成 PDF 书签（**默认生成**，见下） |
+| `--link-urls` | 正文链接后附 URL（纸质可读） |
+| `--landscape` | 横向页面 |
+| `--font-size <pt>` | 正文字号，默认 10.5 |
+| `--margin <mm>` | 页边距，默认 20；可写 `"20,18"`（上下,左右） |
+| `--no-footer` | 不要页脚页码 |
+| `--footer-left / --footer-right <text>` | 页脚左右文字 |
+| `--colophon <text>` | 文末落款（默认：来源文件名） |
+| `--keep-html` | 保留中间 HTML，方便调样式 |
+| `--html-only` | 只生成 HTML，不启动浏览器（调样式 / CI 校验用） |
+| `--open` | 完成后打开 PDF |
+
+布尔选项支持 `--flag=false`。环境变量：`MD2PDF_CHROME`、`MD2PDF_NODE`、`MD2PDF_WS=mini`。
+
+### 目录与书签是两件事
+
+| | 是什么 | 在哪看 | 怎么开 |
+| --- | --- | --- | --- |
+| **目录页** | 排在文首的一张目录，条目是**可点击的内链** | 文档第 1 页 | `-t / --toc`（默认关） |
+| **PDF 书签** | PDF 阅读器侧边栏里的**章节大纲树**（可折叠、点击跳转） | 阅读器侧栏 | **默认开**，`--no-outline` 关 |
+
+书签由 Chrome 按 HTML 的 `h1`–`h6` 结构生成（报头标题为根，H2/H3 逐层嵌套），
+所以只要文档用了标准标题层级，就有对应的大纲，不需要额外配置。
+
+需要看侧栏的阅读器操作：macOS 预览需手动展开侧栏（**⌘⌥3**，或右上角侧栏按钮）；
+Acrobat / 福昕 / Chrome 内置阅读器点侧栏图标即可。侧栏是否自动展开由阅读器自身决定，
+本工具不写 `/PageMode`（改这个字段要重写 PDF 目录对象，收益不值那份风险）。
+
+自己验一份 PDF 的书签与内链：
+
+```bash
+node ci/inspect-pdf.mjs out.pdf
+```
+
+## 排版规则
+
+- 首个 H1 提升为报头大标题，正文不再重复；其后的首段自动成为导语。
+- YAML frontmatter 的 `name` / `description` 生成元信息条；description 里「适用于…」「不用于…」会自动拆成「适用 / 不适用」两栏。
+- H2 自动分节并加色块标记；表格深色表头＋隔行浅底；有序列表用圆形序号。
+- 相对路径图片自动解析成绝对地址，能正常进入 PDF。
+
+## 改样式
+
+```
+assets/base.css              骨架（占位符 {{PAGE_SIZE}} {{MARGIN_*}} {{FONT_SIZE}}）
+assets/theme-elegant.css     墨蓝 + 古铜（默认）
+assets/theme-minimal.css     黑白公文
+assets/shell.html            页面骨架
+```
+
+改完直接重跑命令，不用重启任何东西。
+
+## 它是怎么工作的
+
+```
+Markdown ──(marked)──▶ HTML ──(模板+主题 CSS)──▶ 完整 HTML
+        ──▶ 无头 Chrome（CDP Page.printToPDF）──▶ PDF
+```
+
+选 CDP 而不是 `chrome --print-to-pdf` 的原因：命令行版不支持页眉页脚模板，出不了页码。
+`preferCSSPageSize: true` 让页面尺寸/边距完全由 CSS `@page` 控制。
+
+## 校验与 CI
+
+```bash
+bash ci/validate.sh        # 本地跑，和 CI 完全同一套检查（约几秒）
+```
+
+校验分四层，全部不需要浏览器：
+
+1. **结构**：必需文件齐全、`bin/` 与安装脚本有可执行位、关键文件确实被 git 跟踪
+2. **语法**：`sh -n`、`node --check`
+3. **一致性**：版本号（package.json ↔ src）；模板占位符 ↔ 替换逻辑双向闭合；
+   主题 CSS 里 `var(--x)` 全部有定义；占位符替换必须是全量的
+4. **行为**：`--help`/`--version` 冒烟；`examples/demo.md` 端到端渲染到 HTML，
+   断言表格、代码块、引用、嵌套列表、目录、链接 URL、分节都在，且无占位符残留
+   与 `undefined` 泄漏；目录锚点与标题 `id` 一一对应
+5. **接线**：PDF 书签这类"只存在于 PDF 里"的特性，CI 没有浏览器验不了结果，
+   就退一步断言参数真的传进了 `printToPDF`、开关真的从 `main` 接到了渲染 ——
+   光有 `case '--no-outline'` 不等于接到了
+
+最后还有一步**守卫自测**：故意破坏一份副本（塞入未定义的占位符、改错主题变量名、
+改乱版本号、把目录项退回纯文本、关掉书签参数…），断言校验确实会失败 ——
+只会"全绿"的校验等于没有校验。
+
+CNB 云原生构建在 push / PR 时跑同一脚本；打 tag 时发布到 npm
+（见 `.cnb.yml`）。
+
+### 发版
+
+改完 `src/md2pdf.mjs` 的 `VERSION` 与 `package.json` 的 `version`（校验会检查两者一致），然后：
+
+```bash
+git tag v1.4.0 && git push origin v1.4.0
+```
+
+流水线会自动：校验 → `npm publish --access public`（发布到 npm，需在 CNB 项目里配置 `NPM_TOKEN` secret）。
+也可以本地手动 `npm publish`。
+
+注意 CNB **不允许删除 tag**，打错了只能升版本号再发一版。
+
+## 目录结构
+
+```
+bin/md2pdf              启动器（解析软链、挑选 node）
+src/md2pdf.mjs          主程序
+src/ws.mjs              Node < 22 时的极简 WebSocket 客户端
+src/install-skill.mjs   npm postinstall：把技能说明书装进 WorkBuddy
+assets/                 样式与页面骨架
+vendor/marked.esm.js    内置 Markdown 解析器
+examples/demo.md        示例文档（含表格/代码/引用/嵌套列表）
+ci/validate.sh          校验入口（本地与 CI 同一套）
+ci/checks.mjs           一致性 + 端到端渲染断言
+ci/inspect-pdf.mjs      读出 PDF 的书签树与链接注解（本地验证 outline 用）
+skill/SKILL.md          Agent 技能说明书（postinstall 会装到技能目录）
+```
+
+
+
+## 常见问题
+
+**装到哪了 / 怎么升级** → npm 全局包在 `npm root -g` 下的 `@jiyeqian/md2pdf`，命令软链进 npm 的 bin 目录。
+升级：`npm update -g @jiyeqian/md2pdf`。
+
+**npm 装不上** → 确认 npm registry 可达；也可以 clone 仓库后 `npm link` 本地开发。
+
+**找不到 Chrome** → 设 `export MD2PDF_CHROME=/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome`
+
+**Node 版本老** → 升级到 22+；不想升也能用（自动走内置 WebSocket），只是没在老版本上充分测试。
+
+**PDF 里目录不能点击** → Chrome 打印不保留内部锚点跳转，目录是纯文本。
+
+**想改默认字号/边距** → 直接改命令行参数；要永久生效就改 `src/md2pdf.mjs` 里 `parseArgs` 的默认值。
+
+## License
+
+MIT
+
+第三方组件：`vendor/marked.esm.js` 来自 [marked](https://github.com/markedjs/marked)（MIT License），随仓库分发以便零依赖安装。

package/assets/base.css

@@ -0,0 +1,222 @@
+/* md2pdf — 基础排版（与主题无关的骨架）
+   占位符：{{MARGIN_TOP}} {{MARGIN_BOTTOM}} {{MARGIN_SIDE}} {{FONT_SIZE}} */
+
+@page {
+  size: {{PAGE_SIZE}};
+  margin: {{MARGIN_TOP}} {{MARGIN_SIDE}} {{MARGIN_BOTTOM}};
+}
+
+:root {
+  --doc-font-size: {{FONT_SIZE}};
+}
+
+* { box-sizing: border-box; }
+
+html {
+  -webkit-print-color-adjust: exact;
+  print-color-adjust: exact;
+}
+
+body {
+  margin: 0;
+  background: var(--paper);
+  color: var(--text);
+  font-family: var(--font-body);
+  font-size: var(--doc-font-size);
+  line-height: 1.9;
+  /* 中文正文不加字间距：否则 PDF 复制/检索时会被拆成单字 */
+  letter-spacing: 0;
+}
+
+/* ---------- 报头 ---------- */
+.masthead {
+  padding-bottom: 14px;
+  border-bottom: var(--masthead-border);
+}
+
+.kicker {
+  font-size: 8pt;
+  letter-spacing: .28em;
+  text-transform: uppercase;
+  color: var(--accent);
+  font-weight: 600;
+  margin-bottom: 10px;
+}
+.kicker:empty { display: none; }
+
+h1 {
+  font-family: var(--font-head);
+  font-size: 2.5em;
+  font-weight: 700;
+  color: var(--ink);
+  margin: 0 0 12px;
+  line-height: 1.25;
+  letter-spacing: 0;
+}
+
+.lead {
+  font-size: 1.05em;
+  color: var(--ink-soft);
+  line-height: 1.95;
+  margin: 0;
+  text-align: justify;
+}
+
+/* ---------- 元信息条 ---------- */
+.meta {
+  display: flex;
+  gap: 0;
+  margin: 16px 0 30px;
+  padding: 12px 16px;
+  background: var(--tint);
+  border-left: 3px solid var(--accent);
+}
+.meta:empty { display: none; }
+.meta-item { flex: 1; padding-right: 16px; }
+.meta-item + .meta-item { border-left: 1px solid var(--rule); padding-left: 16px; }
+.meta-label {
+  display: block;
+  font-size: 7.5pt;
+  letter-spacing: .18em;
+  color: var(--accent);
+  font-weight: 600;
+  margin-bottom: 4px;
+}
+.meta-value { font-size: 9pt; color: var(--text); line-height: 1.7; }
+
+/* ---------- 目录 ---------- */
+.toc {
+  margin: 0 0 28px;
+  padding: 14px 18px;
+  background: var(--tint);
+  border: 1px solid var(--rule);
+}
+.toc-title {
+  font-size: 7.5pt; letter-spacing: .2em; color: var(--accent);
+  font-weight: 600; margin-bottom: 8px;
+}
+.toc ol { margin: 0; padding-left: 18px; counter-reset: toc; list-style: none; }
+.toc li { position: relative; margin: 3px 0; font-size: 9.5pt; }
+.toc li::before {
+  counter-increment: toc; content: counter(toc,decimal-leading-zero);
+  color: var(--accent); font-family: var(--font-mono);
+  font-size: 8.5pt; margin-right: 8px;
+}
+.toc a { color: var(--ink); text-decoration: none; border: none; }
+
+/* ---------- 章节 ---------- */
+section { margin-bottom: 26px; }
+section:last-of-type { margin-bottom: 8px; }
+
+h2 {
+  font-family: var(--font-head);
+  font-size: 1.38em;
+  font-weight: 700;
+  color: var(--ink);
+  margin: 0 0 14px;
+  padding: 2px 0 8px 14px;
+  border-bottom: 1px solid var(--rule);
+  position: relative;
+  line-height: 1.5;
+}
+h2::before {
+  content: ""; position: absolute; left: 0; top: 6px; bottom: 10px;
+  width: 4px; background: var(--accent);
+}
+
+h3 {
+  font-family: var(--font-head);
+  font-size: 1.12em; font-weight: 700; color: var(--ink);
+  margin: 22px 0 10px; line-height: 1.5;
+}
+h4 {
+  font-size: 1em; font-weight: 700; color: var(--ink-soft);
+  margin: 16px 0 8px;
+}
+
+p { margin: 0 0 12px; text-align: justify; }
+p:last-child { margin-bottom: 0; }
+
+/* ---------- 表格 ---------- */
+table {
+  width: 100%; border-collapse: collapse;
+  margin: 4px 0 16px; font-size: .92em;
+}
+thead th {
+  text-align: left; padding: 8px 10px;
+  font-weight: 600; letter-spacing: .05em; font-size: .95em;
+}
+tbody td {
+  padding: 9px 10px; border-bottom: 1px solid var(--rule);
+  vertical-align: top; line-height: 1.75; text-align: justify;
+}
+tbody td:first-child { font-weight: 600; color: var(--ink); }
+
+/* ---------- 列表 ---------- */
+ol, ul { margin: 0 0 14px; padding-left: 0; }
+ol { list-style: none; counter-reset: step; }
+ol li { position: relative; padding-left: 30px; margin-bottom: 11px; text-align: justify; }
+ol li:last-child { margin-bottom: 0; }
+ol li::before {
+  counter-increment: step; content: counter(step);
+  position: absolute; left: 0; top: .28em;
+  width: 1.55em; height: 1.55em; line-height: 1.55em; text-align: center;
+  font-family: var(--font-mono); font-size: .82em; font-weight: 700;
+}
+ul { list-style: none; }
+ul li { position: relative; padding-left: 18px; margin-bottom: 11px; text-align: justify; }
+ul li:last-child { margin-bottom: 0; }
+ul li::before {
+  content: ""; position: absolute; left: 2px; top: .82em;
+  width: 5px; height: 5px; border-radius: 50%;
+}
+li > ul, li > ol { margin: 8px 0 0; }
+li p { margin-bottom: 6px; }
+
+/* ---------- 行内 ---------- */
+strong { color: var(--ink); font-weight: 600; }
+em { font-style: normal; color: var(--ink-soft); }
+code {
+  font-family: var(--font-mono); font-size: .88em;
+  background: var(--tint); color: var(--ink);
+  padding: 1.5px 5px; border-radius: 3px; border: 1px solid var(--rule);
+}
+a { color: var(--ink); text-decoration: none; border-bottom: 1px solid var(--accent-soft); }
+a.ref { border-bottom: 1px dotted var(--accent); word-break: break-all; }
+.link-url { font-family: var(--font-mono); font-size: .75em; color: var(--muted); }
+
+/* ---------- 代码块 / 引用 / 分隔线 ---------- */
+pre {
+  background: var(--code-bg); color: var(--code-fg);
+  border: 1px solid var(--rule); border-radius: 4px;
+  padding: 12px 14px; margin: 0 0 14px;
+  overflow: hidden; white-space: pre-wrap; word-break: break-word;
+}
+pre code {
+  background: transparent; border: none; padding: 0;
+  color: inherit; font-size: .85em; line-height: 1.7;
+}
+blockquote {
+  margin: 0 0 14px; padding: 10px 14px;
+  background: var(--tint); border-left: 3px solid var(--accent-soft);
+  color: var(--ink-soft); font-size: .95em; text-align: justify;
+}
+blockquote p:last-child { margin-bottom: 0; }
+hr {
+  border: none; border-top: 1px solid var(--rule);
+  margin: 24px 0;
+}
+img { max-width: 100%; height: auto; display: block; margin: 8px auto 14px; }
+
+/* ---------- 文末 ---------- */
+.colophon {
+  margin-top: 32px; padding-top: 12px; border-top: 1px solid var(--rule);
+  display: flex; justify-content: space-between;
+  font-size: 8pt; color: var(--muted); letter-spacing: .08em;
+}
+.colophon:empty { display: none; }
+
+/* ---------- 分页控制 ---------- */
+h1, h2, h3, h4, thead { break-after: avoid; }
+tr, li, pre, blockquote, img { break-inside: avoid; }
+section { break-inside: auto; }

package/assets/shell.html

@@ -0,0 +1,31 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8">
+<title>{{TITLE}}</title>
+<style>
+{{CSS}}
+</style>
+</head>
+<body>
+
+<header class="masthead">
+  <div class="kicker">{{KICKER}}</div>
+  <h1>{{TITLE}}</h1>
+  <p class="lead">{{LEAD}}</p>
+</header>
+
+{{META}}
+{{TOC}}
+
+<main>
+{{BODY}}
+</main>
+
+<div class="colophon">
+  <span>{{COLOPHON_LEFT}}</span>
+  <span>{{COLOPHON_RIGHT}}</span>
+</div>
+
+</body>
+</html>

package/assets/theme-elegant.css

@@ -0,0 +1,32 @@
+/* 主题：elegant（默认）—— 墨蓝 + 古铜，带底色块 */
+:root {
+  --ink: #1b2a41;
+  --ink-soft: #33465f;
+  --accent: #8a6d3b;
+  --accent-soft: #c9b48f;
+  --paper: #ffffff;
+  --tint: #f6f4ef;
+  --rule: #e4e0d7;
+  --text: #262626;
+  --muted: #8a8578;
+
+  --code-bg: #f8f7f3;
+  --code-fg: #26303d;
+
+  --font-body: "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", sans-serif;
+  --font-head: "Songti SC", "Source Han Serif SC", "STSong", serif;
+  --font-mono: "SF Mono", "Menlo", "Consolas", monospace;
+
+  --masthead-border: 2.5px solid var(--ink);
+}
+
+thead th { background: var(--ink); color: #fff; border: none; }
+tbody tr:nth-child(even) { background: #fbfaf7; }
+
+ol li::before {
+  background: var(--tint);
+  border: 1px solid var(--accent-soft);
+  border-radius: 50%;
+  color: var(--accent);
+}
+ul li::before { background: var(--accent-soft); }

package/assets/theme-minimal.css

@@ -0,0 +1,40 @@
+/* 主题：minimal —— 纯黑白灰，无底色块，适合正式公文/报告 */
+:root {
+  --ink: #141414;
+  --ink-soft: #3d3d3d;
+  --accent: #555555;
+  --accent-soft: #b8b8b8;
+  --paper: #ffffff;
+  --tint: #ffffff;
+  --rule: #dcdcdc;
+  --text: #1f1f1f;
+  --muted: #8c8c8c;
+
+  --code-bg: #f6f6f6;
+  --code-fg: #23272e;
+
+  --font-body: "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", sans-serif;
+  --font-head: "PingFang SC", "Hiragino Sans GB", sans-serif;
+  --font-mono: "SF Mono", "Menlo", "Consolas", monospace;
+
+  --masthead-border: 1px solid #141414;
+}
+
+.kicker { color: var(--muted); }
+h2::before { width: 3px; background: #141414; }
+
+.meta { border-left: 2px solid #141414; background: #fff; padding-left: 14px; }
+.toc { background: #fff; }
+blockquote { background: #fff; border-left: 2px solid #141414; }
+
+thead th {
+  background: #fff; color: var(--ink);
+  border-top: 1px solid #141414; border-bottom: 1px solid #141414;
+}
+tbody tr:nth-child(even) { background: #fafafa; }
+
+ol li::before {
+  background: #fff; border: 1px solid #b8b8b8; border-radius: 0;
+  color: var(--ink);
+}
+ul li::before { background: #8c8c8c; border-radius: 0; }

package/bin/md2pdf

@@ -0,0 +1,49 @@
+#!/bin/sh
+# md2pdf —— Markdown → 优雅 PDF
+# 用法见：md2pdf --help
+#
+# 通过软链接调用也能正确定位项目根目录。
+# 环境变量 MD2PDF_NODE 可强制指定 node 可执行文件。
+
+set -e
+
+# 解析软链接，找到真实脚本所在目录
+SOURCE="$0"
+while [ -L "$SOURCE" ]; do
+  DIR="$(cd -P "$(dirname "$SOURCE")" && pwd)"
+  SOURCE="$(readlink "$SOURCE")"
+  case "$SOURCE" in
+    /*) ;;
+    *) SOURCE="$DIR/$SOURCE" ;;
+  esac
+done
+ROOT="$(cd -P "$(dirname "$SOURCE")/.." && pwd)"
+
+# 选一个 node：优先 >= 22（有全局 WebSocket）；找不到就用任意可用版本
+node_major() {
+  "$1" -p 'process.versions.node.split(".")[0]' 2>/dev/null || echo 0
+}
+
+pick_node() {
+  if [ -n "$MD2PDF_NODE" ] && [ -x "$MD2PDF_NODE" ]; then echo "$MD2PDF_NODE"; return; fi
+  candidates="$HOME/.workbuddy/binaries/node/versions/22.22.2-3/bin/node
+/usr/local/bin/node
+/opt/homebrew/bin/node
+/usr/bin/node
+$(command -v node 2>/dev/null)"
+  for c in $candidates; do
+    [ -x "$c" ] || continue
+    if [ "$(node_major "$c")" -ge 22 ] 2>/dev/null; then echo "$c"; return; fi
+  done
+  for c in $candidates; do
+    [ -x "$c" ] && { echo "$c"; return; }
+  done
+}
+
+NODE="$(pick_node)"
+if [ -z "$NODE" ]; then
+  echo "md2pdf: 未找到 Node.js（建议 >= 22）。可设置 MD2PDF_NODE=/path/to/node" >&2
+  exit 1
+fi
+
+exec "$NODE" "$ROOT/src/md2pdf.mjs" "$@"

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@jiyeqian/md2pdf",
+  "version": "1.4.0",
+  "description": "把 Markdown 排成优雅的中文 A4 PDF（无头 Chrome 渲染，带报头、表格/代码排版与页脚页码）",
+  "type": "module",
+  "bin": {
+    "md2pdf": "bin/md2pdf"
+  },
+  "files": [
+    "bin",
+    "src",
+    "assets",
+    "vendor",
+    "skill",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "postinstall": "node src/install-skill.mjs",
+    "validate": "bash ci/validate.sh",
+    "test": "bash ci/validate.sh",
+    "demo:pdf": "node src/md2pdf.mjs examples/demo.md -o /tmp/md2pdf-demo.pdf"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "markdown",
+    "pdf",
+    "cli",
+    "chinese",
+    "typography"
+  ],
+  "license": "MIT"
+}