技能介绍

要解决什么问题

日常交付里经常要在 Word、PDF、Markdown、HTML 之间倒格式：README 要出 PDF、合同要 Word、静态页要可打印的 PDF。通用在线转换往往涉及上传、版式丢失或中文字体错乱；在 Agent 对话里，你更需要一套能在本机跑、路径明确的转换流程，而不是让模型「口头描述」怎么装工具。

技能如何工作

该技能把常见路径拆成可执行的 Python 脚本，并按来源格式选用不同栈：

.docx → .pdf：python-docx 读结构，配合 fpdf2 出 PDF
.md → .pdf / .docx：解析 Markdown 标题、列表、代码块等，再分别写入 PDF 或 Word
.html → .pdf：走 pdfkit / wkhtmltopdf 渲染网页为 PDF
.docx → .md：用 python-docx 抽取正文，便于二次编辑

触发上可用中英文意图，例如「转换文档格式」「Word转PDF」「Markdown转Word」「HTML转PDF」或 doc-converter。流程上会先 理解需求（源格式、目标格式、输出路径），再生成或调用对应转换脚本；部分场景支持 自动识别 扩展名并路由到正确管线，并可调节 PDF 质量相关设置。

设计上强调 高保真：尽量保留字体、图片与段落结构，并声明支持中英文等多语言与 Windows / macOS / Linux。

适用边界与注意点

转换在 本地文件 完成：无外网调用、无 API Key，依赖均为开源库（见技能内 Security Notes）。
HTML → PDF 依赖系统级 wkhtmltopdf，环境未安装时会失败，需提前装好。
Word / Markdown → PDF 侧需要 python-docx、fpdf2 等 Python 包；版式是否「像原件」很大程度取决于是否使用 相同或等宽/等衬线字体，中文尤其需要 Unicode 字体 配置，否则易出现缺字或换行异常。
Markdown 转 PDF 的实现会对代码块、表格、引用等做简化处理（例如代码块可能跳过正文渲染），复杂文档建议先目检输出再交付。