乐于分享
好东西不私藏

合同/报告一键转 Word!这个 Skill 办公族必装

合同/报告一键转 Word!这个 Skill 办公族必装

上周写周报,写了 3000 字 markdown。

老板说:交 word 版。

我打开 Word,复制粘贴进去。格式全乱了。标题没了,表格散了,代码块变成了一堆乱码。

花了半小时调格式。

后来发现有个 skill 叫 pdf + docx,专门解决这个问题。

现在我写完 markdown,一条命令直接转 Word,格式完美。


为什么 markdown 转 Word 这么难?

不是技术问题,是生态问题:

• markdown 是程序员的世界:轻量、高效、版本控制友好

• Word 是职场的世界:老板要看 word、客户要 word、打印要 word

• 你夹在中间,两边都要伺候

手动转换的痛点:

1. 格式丢失:标题层级、加粗、代码块全没了

2. 表格散架:markdown 表格变成一堆文字

3. 图片错位:插在 markdown 里的图片跑到奇怪的位置

4. 目录没了:word 文档需要自动生成目录,手动加很麻烦

我之前的做法是用 Pandoc 命令行转。但 Pandoc 参数太多,每次都要查文档,而且中文支持经常出问题。


pdf + docx:一条命令搞定

这个 skill 做的事情很简单:把 markdown 转成 Word,保留所有格式

安装:

npx skills add agent-infra/pdf-docx

用法:

# 转换 markdown 到 word

pdf-docx convert report.md
# 转换 markdown 到 PDF
pdf-docx convert report.md –pdf
# 批量转换
pdf-docx convert *.md

就这么简单。不需要记参数,不需要查文档。

左边 Markdown 源文件,右边自动生成的 Word 文档。标题、加粗、表格、列表全部保留。


我的实际用法

场景 1:周报

以前:

# 写完 markdown 周报

vim weekly-report.md
# 手动打开 Word,复制粘贴,调格式
# 花 30 分钟

现在:

# 写完 markdown 周报

vim weekly-report.md
# 一条命令
pdf-docx convert weekly-report.md
# 直接发给老板

30 分钟 → 10 秒。

场景 2:技术方案

写技术方案我喜欢用 markdown,因为版本控制方便、写起来快、代码块高亮好。但交付要 word。

# 写完技术方案

vim tech-proposal.md
# 转换
pdf-docx convert tech-proposal.md –output 技术方案v1.docx

格式完美,标题层级保留,代码块有高亮,表格也没散。

场景 3:合同模板

写合同用 markdown,因为结构清晰、变量好改、版本对比方便。但最终要 word 版给客户签。

# 合同模板

vim contract-template.md
# 转成正式版
pdf-docx convert contract-template.md –output 合同-2026Q3.docx

支持哪些格式?

• 标题(h1-h6)

• 加粗、斜体、删除线

• 代码块(带语法高亮)

• 表格

• 图片

• 列表(有序/无序)

• 链接、引用块、分割线

基本上 markdown 支持的,word 都能保留。


避坑指南

• 图片路径问题:图片要用相对路径,不要用绝对路径

• 复杂表格:如果表格列太多(超过 5 列),word 里可能会挤。建议拆分

• 代码块语言:指定语言能获得更好的高亮

• PDF 输出:如果要 PDF,确保系统装了 LaTeX(或者用 --pdf-engine wkhtmltopdf


进阶玩法

批量转换

整个文件夹的 markdown 一键转成 Word:

pdf-docx batch ./docs/ –output ./converted/ –to docx

PDF 逆向提取

PDF 转回 markdown,提取文本和表格:

pdf-docx extract report.pdf –to markdown

OCR 扫描件识别

扫描型 PDF 转可编辑文档:

pdf-docx ocr scan.pdf –output editable.docx

支持中英文混合识别,准确率 99%+。

一键生成 PPT

从 markdown 直接生成演示文稿:

pdf-docx ppt report.md –style business

• business——商务汇报风格

• academic——学术演讲风格

• conference——会议分享风格

• minimal——极简风格


总结

这个 skill 解决的是程序员和职场之间的”格式鸿沟”

• 你用 markdown 写(高效)

• 老板/客户要 word(通用)

• skill 帮你转(自动)

一条命令,30 秒搞定。省下来的时间干点正事。

写 markdown 交 word,以前是苦差事。现在是一条命令的事。

💬 你平时用什么工具把 markdown 转 Word?评论区聊聊。


如果觉得这篇文章有用,欢迎关注「AI 阿砚」,一个科研爱好者的 AI 探索笔记。