WorkBuddy保姆级教程|把Markdown做成精美Word和PDF
智见AI
最近还在给电子工业出版社录 WorkBuddy 实战课。上一篇文章,我拆了 WorkBuddy 的 Deep Research。为了把整个过程讲清楚,我让它围绕 Loop Engineering 重新做了一次深度研究。几个 Subagent 并行找资料,主 Agent 负责汇总,十几分钟后生成了一份 14 章、3 个附录、约 12000 字的白皮书。
内容完成了,新的问题也来了:这份白皮书是一个以 .md 结尾的 Markdown 文件。在 WorkBuddy 右侧的渲染界面里,它有标题、有目录、有表格,看起来和普通文档没有太大区别。但如果打开原始文件,里面会出现大量 #、** 和 -。这些符号对 Agent 很友好,对准备接收材料的领导、客户和学员就没那么友好了。
Markdown语法是非人类友好的
如果你把这样的原始 Markdown 直接发给领导肯定是要挨骂的~接收者要先理解这些符号,也很难按照熟悉的 Word 方式批注和修改。内容虽然写完了,文件还没有进入大多数业务场景真正可交付的状态。
所以接下来的两节课,我分别跑了一遍 Markdown 转 Word 和 Markdown 转 PDF。这篇把两节课合到一起,讲清楚一条完整的文档交付链路。你不需要学习 Markdown 语法,也不需要自己写代码。你真正需要学会的是:先判断文档的终态,再让 Agent 选择正确的工具和路径。
Agent默认产出Markdown文档
面向业务交付时,Markdown 更适合作为 Agent 的工作底稿
在没有指定终稿格式时,WorkBuddy 这类 Agent 通常会把长文写成 Markdown。原因并不复杂:Markdown 本质上还是纯文本,Agent 可以直接读取和修改;标题、列表、引用、表格和代码块又都有清晰的结构,不容易在多轮编辑中把层级弄乱。所以 Markdown 不是一个需要马上消灭的中间产物。对 Agent 来说,它反而是一种非常合适的工作格式。
问题出在后半段。Agent 的工作格式和人的交付格式不是一回事。一个文档到底该转成 Word 还是 PDF,不能只看哪个文件更常见,要看它接下来还要经历什么。我现在会连续问三个问题:发布前还要不要由人继续修改?如果需要,先转成 Word,方便人修改、批注和协作;内容已经定稿后,是「能发就行」,还是需要正式、好看并且带有品牌特色?前者生成基础 PDF,后者走品牌化排版;PDF 生成后还要不要合并、拆分、加水印或加密?如果需要,再进入 PDF 后处理。
把这三个问题回答清楚,工具选择就不会乱:
继续协作
Word
方便修改、批注和多人协作
快速交付
pdfkit-py
生成一份可以直接发送的基础 PDF
品牌成稿
Kami
蒸馏内容并套用品牌视觉系统
工程处理
合并、拆分、水印、加密和填表
先问终态,再选 Skill
Markdown 转 Word:不要被 Skill 的名字骗了
我一开始也走了一条很自然的路:打开 WorkBuddy 的 Skill 商店,搜索 Word。当时搜到的「Word 文档生成」对应 minimax-docx。只看名字,很容易理解成「把任何内容转换成 Word」。但真正把 Skill 的说明读完之后,我发现它的定位并不是一个简单的 Markdown 转 Word 工具,而是一套 Word 创建和编辑引擎。
Minimax开源的minimax-docx skill
提示WorkBuddy 调用 Skill 的三个入口 可以从加号菜单、斜杠命令和自然语言调用 Skill。知道名称时我更常用 `/`;不知道名称时就描述任务,让 WorkBuddy 去商店里查找。无论从哪个入口找到,都先看说明,再安装和执行。
minimax-docx 主要有三条工作管线:从零创建 Word、编辑已有 Word、把已有内容套进 Word 模板。里面还内置了 13 套美学配方,可以控制标题、正文、颜色和版式。它的设计思路挺有意思:给你的是经过组合的配方,不是一桶颜色随便往文档上刷。它很适合制作和美化 Word,却不负责原生解析 Markdown。
这就是我建议大家安装一个 Skill 后,先不要急着执行任务的原因。我通常会先把下面这段话发给 WorkBuddy:
请介绍这个 Skill 的主要功能、工作流程和能力边界。 它能不能直接把 Markdown 转成 Word? 能不能指定一级标题、二级标题和正文的字体、字号与颜色? 能不能使用我提供的 Word 模板? 哪些事情是它明确做不到的?
提示先问清能力边界 很多人问 Skill 只会问「它能做什么」,我更关心「它明确做不到什么」。能力说明决定你会不会用,能力边界决定这个任务值不值得让它来做。如果准备把 Skill 分享给同事或学员,还要问清它来自 WorkBuddy 内置、商店安装,还是自己的本地目录;本地 Skill 需要单独打包交付。
minimax-docx的能力边界
我第一次测试时,没有先把「格式转换」和「Word 排版」拆开,直接要求 minimax-docx 把一千多行的白皮书从 Markdown 做成 Word。Agent 开始分析表格和代码块,初始化运行环境,还要安装一个约 600 MB 的 .NET SDK。七八分钟过去,任务仍然没有完成。
注意这条工具路径已经选错了 我让一个更擅长 Word 创建、编辑和套模板的引擎,额外承担它原本不擅长的 Markdown 解析工作。任务能启动,不等于路径合理。
minimax-docx不适合用来转换Markdown
最短路径:先完成转换,再处理排版
把能力…