前言¶
文档写在 Markdown 里很方便，但要交给同事打印、归档或对外发放，往往还需要再转成 PDF。自己搭 Pandoc、调 CSS、处理中文字体，会占掉不少时间；若在对话里让 Agent 直接完成「读 .md → 出 PDF」，需要一套稳定、可复用的操作指引。下面介绍 SkillHub 上的社区 Skill mdtopdf，它把 Markdown 转 PDF 的流程封装成 Agent 可遵循的说明，适合在 Cursor、Claude Code 等支持 Skills 的环境里启用。
这是什么¶
mdtopdf（坐标 @user_1ae97d99/mdtopdf，版本 1.0.0）是 SkillHub 分类 office-efficiency（子类含文档处理、PDF 处理）下的社区 Skill，由发布者 大森（user_1ae97d99）维护。官方简介为：将 md 转换成 pdf 的 skills；详细说明指出，Skill 通过 Python 的 md2pdf 库、以 WeasyPrint 为渲染引擎，把 Markdown 转为版式规范的 PDF，并强调排版优化、代码语法高亮、分页布局以及中文字体支持。标签 requires_api_key=false，使用时不需要额外配置 API Key。
Skill 页面：https://www.skillhub.cn/skills/user_1ae97d99/mdtopdf
API 坐标：https://api.skillhub.cn/user_1ae97d99/mdtopdf
核心功能¶
根据 SkillHub 页面上的说明，mdtopdf 主要覆盖以下能力（均为官方描述，非第三方推断）：
- Markdown → PDF：将 Markdown 源文件或内容导出为 PDF 文档。
- 出版级版式：通过 md2pdf + WeasyPrint 生成排版较完整的 PDF，包含语法高亮与合理分页。
- 中文场景：说明中明确提到对中文字体的支持，便于中文技术文档、说明类稿件导出。
- 触发语义：当用户提到生成 PDF、导出文档、打印 Markdown、
markdown to PDF/md to pdf、PDF report 等意图时，Agent 应优先考虑启用本 Skill。
平台侧数据（以 SkillHub 页面与抓取信息为准）：评分 100000，下载 734 次，安装 2 次。
安装与启用¶
安装方式遵循 SkillHub 官方文档 SkillHub 安装与优先源配置。先做 CLI 检查，再把 Skill 装到当前 Agent 实际读取的 skills 目录（装错目录 Agent 不会加载）。
1、检查是否已安装 skillhub CLI
command -v skillhub && skillhub --version
若未安装，可按官方文档执行完整安装（示例为文档中的推荐命令）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装 mdtopdf 到对应 Agent 的 skills 目录
文档要求安装时必须使用 --dir，并指向当前环境的 skills 路径。常用路径如下（摘自官方安装文档）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
安装命令示例（将 <skills 目录> 换成上表中的实际路径）：
skillhub install user_1ae97d99/mdtopdf --dir <skills 目录>
也可在 SkillHub 站内搜索 mdtopdf 或坐标 user_1ae97d99/mdtopdf 后按页面提示安装。安装完成后，按你所用客户端的要求刷新或重启 Agent，使 Skill 被重新加载。
典型用法¶
本 Skill 遵循通用 SKILL.md 格式：启用后，Agent 在识别到「从 Markdown 产出 PDF」类需求时，会按 Skill 内步骤调用 md2pdf / WeasyPrint 相关流程（具体命令与依赖以安装包内的 SKILL.md 为准）。
在对话中可以这样描述需求，与官方触发说明一致：
- 指定本地文件：「把
README.md导出成 PDF，用于打印。」 - 指定内容场景：「把这份技术说明的 Markdown 生成可对外发送的 PDF。」
- 使用常见英文表述：「export to PDF」「generate PDF」「markdown to PDF」等。
Agent 应在执行前确认输入路径或 Markdown 内容、输出 PDF 路径，并在本机已具备 Skill 所要求的 Python 与 WeasyPrint 运行环境时完成转换。若环境缺失，应依据 SKILL.md 中的依赖说明安装，而不是跳过字体或引擎配置。
适用场景与注意¶
适合谁
- 经常写 Markdown 文档、偶尔需要 PDF 交付的开发者或技术写作者。
- 希望在 Cursor 等 IDE 里用自然语言完成「导出 PDF」，而不想每次手写转换脚本的用户。
- 需要代码块高亮、基础版式和中文字体支持的中文 PDF 场景（以 Skill 官方描述为边界）。
使用注意
- 社区来源：
source: community，verified: false，使用前可在 SkillHub 页面查看版本与说明，自行评估是否用于生产环境。 - 本机依赖：WeasyPrint 与 md2pdf 通常依赖系统库与 Python 包；不同操作系统安装步骤不同，应以 Skill 包内文档为准。
- 安装目录：未使用
--dir指向 Agent skills 目录时，Skill 可能装在当前目录下的./skills/而不会被识别。 - 下载与安装数据：页面显示下载 734、安装 2；若 CLI 直装失败，以 SkillHub 站内状态为准，必要时从网页重新获取安装指引。
结尾¶
mdtopdf 把「Markdown 转 PDF」收敛成 Agent 可执行的 Skill：基于 md2pdf 与 WeasyPrint，面向排版、高亮与中文字体等常见诉求，且无需 API Key。若你已在用 Cursor 或 Claude Code 管理 Skills，可按上文命令装入对应目录，在需要导出文档时用一句话触发即可。
官方页面：https://www.skillhub.cn/skills/user_1ae97d99/mdtopdf
