Markdown 转 PDF
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_48539314/md2pdf-chrome。
技能介绍
要解决的问题
把一份 Markdown 技术文档变成可交付的 PDF,通常会卡在封面、目录、页码、书签、公式和代码高亮之间。手写 HTML/CSS 容易,但重复维护成本高;交给 AI 生成排版又可能引入不可复现的语义解释。md2pdf 把转换做成固定脚本流程:从 MD 到 PDF,结果尽量稳定。
核心工作流
它依赖 pandoc 解析 Markdown,再用 Playwright 驱动 Chromium 渲染页面。技能会自动检测依赖、询问偏好,并按用户选择生成 output/user-config.json。转换时可根据 YAML front-matter 生成封面,没有 front-matter 时也能用文件名兜底;目录、页码、侧边栏书签由脚本生成。代码高亮、KaTeX 公式、Mermaid 图表均可按需启用,中文排版增强会处理行距、缩进和禁则。
适用边界
它适合单文件 Markdown 转 PDF,尤其是技术文档、方案说明、论文初稿和内部手册。不适合多个 MD 合并成一个 PDF、从零创建 PDF、复杂 LaTeX 环境、深度版式控制、分栏或动态交互图表。若需要水印、页眉、打开密码,需要额外依赖,并按 --header、--watermark、--password 覆盖默认配置。
使用场景
- 把技术方案 Markdown 导出为带封面、目录和 PDF 侧边栏书签的内部评审稿。
- 将含 KaTeX 公式与 Mermaid 图的算法说明转成 A4 PDF,并启用中文行距缩进。
- 把代码评审文档转成默认主题 PDF,保留代码高亮、页码和可点击目录。
- 为论文初稿 Markdown 生成学术风格 PDF,封面取 front-matter 标题并校验环境。
适合人员
- 负责技术方案归档的技术写作者:需要把单份 MD 转成可打印、可检索的正式 PDF。
- 维护内部手册的文档工程师:要给 Markdown 手册加封面、目录、页码和书签。
- 写算法或论文初稿的研究工程师:要在 PDF 中渲染 KaTeX、Mermaid 和代码高亮。
- 交付客户材料的工程师:需要稳定输出 A4、主题切换,并可用页眉或水印覆盖。