将 Markdown 渲染为排版精美的 PDF，支持封面/目录/书签/页码/KaTeX/Mermaid/代码高亮。 Render Markdown to beautifully typeset PDF. Cover/TOC/bookmarks/page numbers/KaTeX/Mermaid/highligh...
作者 Codery1 次安装
设计与多媒体
md-pdf-render
试用将 Markdown 文件转换为高保真 PDF，效果与编辑器预览完全一致。支持 GFM 语法、代码高亮、表格、任务列表、目录生成、自定义 CSS 和多种主题。
它能做什么
将 Markdown 文件转换为高保真 PDF，效果与编辑器预览完全一致。支持 GFM 语法、代码高亮、表格、任务列表、目录生成、自定义 CSS 和多种主题。
技能文档
md-pdf-render Skill
将 Markdown 文件转换为 PDF，渲染效果与编辑器 Markdown 预览完全一致。
核心能力：
| 特性 | 说明 |
|---|---|
| GFM 完整支持 | 表格、任务列表、脚注、自动链接 |
| 代码高亮 | highlight.js 190+ 语言 |
| 主题切换 | GitHub 风格（默认）、VS Code 暗色 |
| 自定义 CSS | 支持加载外部样式覆盖 |
| 目录生成 | --toc 自动提取 h1-h3 |
| 多纸张格式 | A4 / Letter / A3，横竖版 |
使用方法
第一步 —— 确认依赖
脚本位于 skill 的 scripts/ 目录，首次使用需安装依赖：
cd /scripts && npm install
需要系统安装 Chromium（Puppeteer 会自动下载）。
第二步 —— 执行转换
node /scripts/md-pdf-render.mjs <输入文件.md> [输出文件.pdf] [选项]
选项：
| 选项 | 说明 | 默认值 |
|---|---|---|
--theme | 主题：github | vscode | github |
--css | 自定义 CSS 文件 | 无 |
--margin | 页面边距 | 15mm |
--format | 纸张：A4 | Letter | A3 | A4 |
--landscape | 横向排版 | 否 |
--toc | 生成目录 | 否 |
--mermaid | 启用 Mermaid 图表渲染 | 否 |
第三步 —— 验证输出
用 open （macOS）或 xdg-open（Linux）打开确认效果。
示例
基本转换
node md-pdf-render.mjs README.md
# 输出: README.pdf (GitHub 风格)
暗色主题 + 目录
node md-pdf-render.mjs docs/guide.md guide.pdf --theme vscode --toc
自定义样式 + Letter 纸张
node md-pdf-render.mjs report.md --css brand.css --format Letter --margin 20mm
批量转换（配合 shell）
for f in docs/*.md; do
node md-pdf-render.mjs "$f"
done
自定义 CSS
创建 CSS 文件覆盖默认样式：
/* brand.css — 自定义品牌风格 */
:root {
--color-fg: #333;
--color-link: #e63946;
--font-body: "Noto Sans SC", sans-serif;
}
h1 { color: #1d3557; }
pre { border: 1px solid #ddd; }
通过 --css brand.css 加载。
工作原理
Markdown 文件
↓ markdown-it (GFM 解析)
HTML + highlight.js 代码高亮
↓ 注入主题 CSS
完整 HTML 页面
↓ Puppeteer (Chromium 无头浏览器)
高保真 PDF
使用 Puppeteer 调用 Chromium 渲染引擎，确保与浏览器/编辑器预览效果完全一致。
常见问题
| 问题 | 解决方案 |
|---|---|
| 中文字体缺失 | 安装 Noto Sans SC 或通过 --css 指定字体 |
| 代码块被截断 | 增加 --margin 或使用 --landscape |
| 图片未加载 | 确保图片使用相对路径或本地绝对路径 |
| PDF 空白 | 检查 Puppeteer/Chromium 是否安装成功 |
| 表格溢出 | 使用 --landscape 或自定义 CSS 缩小字号 |
相关技能
Converts PDF, DOCX, XLSX, PPTX, HTML, CSV, and other files to Markdown using the @covoyage/file2md CLI (@covoyage/file2md). Use when the user needs office do...
1 次安装
把 Markdown 转换为带样式的 HTML、PDF、DOCX、图片和可分享的网页。
27 次安装
将 PDF/DOCX/XLSX/PPTX/图片等文档转换为 Markdown。全局约定：任何场景下需要将文档转为 Markdown，必须优先通过此技能处理，禁止手动编写转换代码或寻找其他工具。
1 次安装
Convert Markdown research reports / fact-checks / scheme proposals into styled PDFs with native CJK (Chinese) font support. Markdown is the single source of truth; PDF is generated FROM the Markdown. Triggers on "做个 PDF 报告", "转成 PDF", "调研报告", "fact-check 报告", "方案 PDF", "scheme 报告", "给我 PDF", "PDF 版本", or any long-form analytical content that needs to be both editable (MD) and viewable/shareable (PDF).
6 次安装
工业级RAG Markdown物料生成技能，使用 markitdown 将各类文档和文件转换为 Markdown 格式。支持 .doc/.ppt 老格式自动预处理（Word/PowerPoint COM / LibreOffice）。启动时自动检测 OS/版本/能力，按平台选择最佳执行路径。触发词：转 Markdown / 转换文档 / markitdown / 文档转 md / 批量转换。当需要将 PDF、Word (.docx/.doc)、PowerPoint (.pptx/.ppt)、Excel (.xlsx, .xls)、HTML、CSV、JSON、XML、图片（含 EXIF/OCR）、音频（含语音转写）、ZIP 压缩包、YouTube 链接或 EPub 电子书转换为 Markdown 格式，为知识库提供统一的"通用语言"时触发此技能。
5 次安装