القائمة
将 Markdown 文档转换为带专业排版和中文支持的 PDF。流程为 Markdown → 带样式 HTML → PDF（用无头 Chromium 打印）。适用于把报告、文档等 .md 文件导出为可交付的 PDF，环境无需 pandoc/wkhtmltopdf/latex。
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/infometa/workbuddyskills --skill md2pdfيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | md2pdf |
| description | 将 Markdown 文档转换为带专业排版和中文支持的 PDF。流程为 Markdown → 带样式 HTML → PDF（用无头 Chromium 打印）。适用于把报告、文档等 .md 文件导出为可交付的 PDF，环境无需 pandoc/wkhtmltopdf/latex。 |
把 Markdown 转换为排版精良、完整支持中文的 PDF：
Markdown ──(python-markdown)──> 带样式 HTML ──(playwright/Chromium 打印)──> PDF
输出特性：A4 版面、红/蓝/朴素三套主题、红底白字表头 + 斑马纹表格、引用框、关键文字加粗高亮、页脚页码，并可选生成封面页、目录页与 PDF 书签（侧边栏可跳转）。
经实测，常见的 CI/容器/桌面环境通常：
markdown 库；playwright-cli 全局命令不可用，且其封装默认找 chrome channel 会报错；本技能为跨平台设计，支持 Linux / macOS / Windows。各平台差异主要体现在：
python3，Windows 常为 python。PLAYWRIGHT_NODE_MODULES）；找不到时按"常见问题"设置环境变量。首次使用前，确保以下四项就绪（命令幂等，可重复执行）：
pip install markdown 2>/dev/null || python3 -m pip install markdown
脚本会自动探测 playwright 的 node_modules 位置；Chromium 内核需用 playwright 自带命令安装：
# 通用（推荐）
npx playwright install chromium
# 若已知 playwright 的 node_modules 路径，也可直接调用其 cli.js
# node <playwright的node_modules>/playwright/cli.js install chromium
必装，否则中文渲染为方块。按你的包管理器选择：
# RHEL/CentOS/Fedora 系 (dnf)
dnf install -y google-noto-sans-cjk-ttc-fonts google-noto-serif-cjk-ttc-fonts && fc-cache -f
# Debian/Ubuntu 系 (apt-get)
apt-get install -y fonts-noto-cjk && fc-cache -f
# macOS (Homebrew，系统通常已有中文字体；缺时可装)
brew install --cask font-noto-sans-cjk-sc font-noto-serif-cjk-sc && fc-cache -f 2>/dev/null || true
# Windows：系统自带中文字体，通常无需额外安装
# RHEL/CentOS/Fedora 系
dnf install -y google-noto-emoji-color-fonts && fc-cache -f
# Debian/Ubuntu 系
apt-get install -y fonts-noto-color-emoji && fc-cache -f
# macOS：系统自带 Apple Color Emoji，通常无需额外安装
# Windows：系统自带 Segoe UI Emoji，通常无需额外安装
脚本会自动检测中文字体与 emoji 字体，缺失时打印警告并给出安装命令，但不会自动安装。 CSS 的
font-family链尾已内置"Noto Color Emoji"，装好字体后 emoji 即可彩色渲染，无需改脚本。
路径以技能包内的相对路径表示。
<skill_dir>指skills/md2pdf目录。
# Linux / macOS
python3 <skill_dir>/scripts/md2pdf.py <input.md> [选项]
# Windows
python <skill_dir>\scripts\md2pdf.py <input.md> [选项]
| 参数 | 说明 | 默认 |
|---|---|---|
input | 输入 .md 文件路径（必填） | — |
-o, --output | 输出 PDF 路径 | 与输入同名 .pdf |
--title | 文档标题（PDF 元信息） | 输入文件名 |
--theme | 配色：red / blue / plain | red |
--footer | 页脚文字 | 同标题 |
--cover | 生成封面页 | 否 |
--subtitle | 封面副标题（配合 --cover） | 空 |
--meta | 封面元信息，形如 "报告类型=xxx;数据来源=yyy;密级=机密"（; 分隔，= 分键值，支持中文） | 空（开启封面时自动补「生成时间」） |
--toc | 生成目录页（基于 H1/H2/H3） | 否 |
--bookmarks / --no-bookmarks | PDF 书签（侧边栏大纲） | 默认开启 |
--keep-html | 保留中间 HTML 文件 | 否 |
# 最简
python3 scripts/md2pdf.py 报告.md
# 指定输出、标题、蓝色主题、自定义页脚
python3 scripts/md2pdf.py 报告.md \
-o ./out/业务报告.pdf \
--title "业务机会分析报告" --theme blue \
--footer "业务机会分析报告（机密）"
成功时输出：[md2pdf] 完成 ✅ <路径> (<大小> KB)。
markdown 库 + 扩展（tables / fenced_code / sane_lists / nl2br / attr_list），套用内联 CSS 主题。--cover 时注入居中封面页（标题+副标题+元信息表）；--toc 时扫描 H1/H2/H3 注入带锚点的目录页，二者均自动分页。node_modules：
PLAYWRIGHT_NODE_MODULES（最高优先级）node_modules（随技能包分发时）~/.bg-agent/node/node_modules、~/.cache/ms-playwright、/usr/lib/node_modules、/usr/local/lib/node_modules、Windows 的 %LOCALAPPDATA%\ms-playwright 等）chromium.launch() → page.goto(file://…) → page.pdf()，A4、printBackground、带页脚页码。开启书签时用 tagged:true+outline:true，Chromium 依 H1/H2/H3 层级自动生成 PDF 书签，无需额外工具。fc-list :lang=zh 为空时告警缺中文字体；fc-list 中无 emoji 字体时告警缺彩色 emoji 字体。CSS font-family 链尾已内置 "Noto Color Emoji"，装好字体即彩色渲染。npx playwright install chromium。node_modules 目录：
# Linux / macOS
export PLAYWRIGHT_NODE_MODULES=/path/to/node_modules
# Windows (PowerShell)
$env:PLAYWRIGHT_NODE_MODULES = "C:\path\to\node_modules"
.md → 交付级 PDF（中文场景），支持封面页、目录页、PDF 书签。