Markdown 转 Word 与 PDF
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_8416807e/ccsk-001。
技能介绍
要解决什么问题
工程师和写文档的人经常手头是 .md 源稿,但对外交付或归档却要 Word(.docx) 或 PDF。若走上 pandoc、LaTeX 或 GTK 依赖链,装环境和排错往往比转换本身更费时。本技能面向「给定 Markdown 路径,在本地直接出 docx / pdf」这一件事。
技能如何工作
核心是目录下的 scripts/convert.py:纯 Python 走 Markdown → HTML → docx/PDF。缺依赖时脚本会提示,常见补装为 markdown、lxml、python-docx、xhtml2pdf。
执行上按 SKILL 约定:先确认源文件与目标格式(未说明时默认 docx;同时要两种格式用 --format both),再调用脚本。支持多文件输入、--output 指定输出目录、--toc 按 1–3 级标题生成目录、--title 覆盖文档标题。中文在 Word 侧由 python-docx 处理;PDF 侧用内置 CID 宋体,本地 PNG/JPG 等光栅图会内联进文档。
边界与注意点
不适用:Word/PDF 反查 Markdown、改已有 docx/pdf、转 HTML 网页。PDF 中文统一宋体,粗体/斜体字重在 PDF 里不可靠;目录与脚注在 PDF/DOCX 中多为不可点击的纯文本;SVG 不会内联。有字重或复杂排版需求时需换其他引擎(如 pandoc + LaTeX)。
使用场景
- 产品/技术同学要把 README 或设计说明 .md 交给非技术同事,需要生成一份 .docx 方便批注
- 法务或商务要求对外附件必须是 PDF,手头只有项目里的 Markdown 定稿
- 仓库里有多篇 .md 发布说明,要按文件名批量转成 docx 并存到同一输出目录
- 写技术方案时需要带目录的 Word 稿,对源文件执行转换并打开 --toc 生成 1–3 级标题目录
适合人员
- 维护开源仓库、经常要把 CHANGELOG/README 导出成 Word 给运营或市场的维护者
- 不写 LaTeX、也不想装 pandoc,只要在当前 Python 环境里把单篇 md 打成 PDF 的技术写作者
- 需要将多路径 Markdown 一次性转成 docx 与 pdf 的文档工程师或实施顾问
- 交付物必须是 Office 格式、且文档含中文与本地截图的内嵌技术文档撰写者