1. 为什么我要做这个Skill？
周五下午5:50，你收拾好包，正准备下班。
电脑"叮"的一声——老板发来消息：“小王，把这个PDF技术方案转成Word，周一投标要用。顺便说一下，格式要规范，字体用微软雅黑，标题用黑体，表格要有边框底纹。”
你打开PDF一看——128页，包含目录、技术方案、报价表格、施工图纸、附录规范。
你苦笑一下，打开了市面上最有名的PDF转Word工具，点了"开始转换"，等待……
5分钟后，转换完成。
你满怀希望地打开生成的Word文件——
噩梦开始了：
- 原本精美的字体全变成宋体，标题层级全部丢失
- 表格边框消失，列宽错乱，合并单元格全部分离
- 图片位置跑偏，有的直接变成红叉，图纸看不清
- 段落间距混乱，行距忽大忽小，原本精美的排版变成一堆"文字墙"
你看了看时间：晚上7:30。家人打来电话：“你还回来吃饭吗？”
你深吸一口气，回复：“你们先吃吧，我加个班。”
然后你开始手动调整——改字体、调表格、插图片、修格式、对齐段落……
这就是我开发 document-reformatter 的初衷。
我不是专业程序员，只是一个被文档格式折磨到焦虑的普通用户。每次面对格式问题，我都觉得自己在做"无意义重复劳动"——这些时间，本来可以用来陪家人、学习新技能、或者早点下班休息。
痛点一：PDF转Word，样式全丢
这是最让人崩溃的。你辛辛苦苦排好的PDF，转成Word后——所有样式信息丢失，排版错乱，像被"格式化"了一样。
- 标题层级丢失，所有文字变成正文
- 表格错乱，样式消失，边框、底色、对齐全部重置
- 错误的换行、换页、大量的无用空格
- 段落间距、行距、缩进全部丢失
你不得不用一个周末，把格式重新排一遍。
痛点二：格式排版的无限循环
即使是从Markdown转Word，也会遇到：
- 表格合并单元格丢失、列宽错乱
- 图片引用断裂，变成红叉
- Word中的Visio对象、SmartArt图形无法正确提取
- 图片顺序错乱，后续图片全错位
痛点三：知识库复用难
Markdown 写知识库确实香，但日常流转和使用中大多数还是使用 docx 文档。Md 转成正式文档时——标题样式全丢、表格支离破碎、图片引用断裂。内容可以流转，样式没法继承，你积累的知识无法高效复用。
痛点四：样式模板无法满足个性化需求
大多数排版工具只提供固定模板，无法满足：
- 团队专属的品牌规范
- 特殊行业的格式要求（如学术论文、政府公文）
- 个性化的排版风格
2. 它有什么优势？
核心价值：让文档格式处理不再焦虑
| 传统方式 | 使用 document-reformatter |
|---|---|
| 手动调整格式，耗时几小时 | 一键转换，3分钟搞定 |
| 表格、图片经常错位 | 智能识别，保持原样 |
| 无法复用团队样式 | 支持自定义模板，一次配置永久使用 |
| 转换后需要大量手工修复 | 转换完成即可使用，基本无需调整 |
三大核心优势：
- 智能标题识别 - 自动识别"第X章"、"X.X.X"等多种编号格式，不再手动设置层级
- 完美处理图片 - 支持Visio/SmartArt，图片按文档顺序正确插入
- 自定义模板 - 可以根据需要新增 docx 样式模板（或修改原有模板），满足团队个性化需求
3. 使用场景
| 场景 | 说明 | 省下的时间 |
|---|---|---|
| 技术团队 | Markdown知识库转技术方案、投标文件 | 每次节省2-3小时 |
| 学术写作 | 论文格式统一、参考文献排版 | 避免反复调整格式 |
| 企业办公 | 公文排版标准化、通知模板套用 | 统一团队文档风格 |
| 跨团队协作 | 统一不同工具产生的文档格式 | 减少跨文档复制带来的格式混乱 |
4. 如何调用？
调用方式一：斜杠命令（推荐）
在对话框中输入：
/document-reformatter <你的文件路径>
示例：
# 转换单个文件，默认为技术方案排版
/document-reformatter ./技术方案.md
# 转换并设置输出格式，默认为技术方案排版
/document-reformatter ./投标文档.pdf --output-format docx
# 使用自定义模板
/document-reformatter ./知识库.md --template 企业标准模板.docx
调用方式二：自然语言
直接说：
- “帮我把这个Markdown转成Word，用技术方案样式排版”
- “转换 XXX 文档为技术方案样式排版”
- “把 XX文档转成公文样式排版”
大模型会自动识别你的意图，调用 document-reformatter 进行处理。
支持的文件格式
| 输入格式 | 输出格式 | 说明 |
|---|---|---|
| Markdown (.md) | Word (docx) | 最常用，知识库转正式文档 |
| PDF (.pdf) | Word (docx) | 保留原样式，避免格式丢失 |
| Word (.docx、. doc) | Word (docx) | 应用模板，统一格式 |
| HTML、TeX、RTF 等 | Word (docx) | 支持8种格式互转 |
进阶用法：自定义模板
如果你有团队专属模板，只需：
- 准备好你的模板文件（.docx格式）
- 在调用时指定：
/document-reformatter 输入文件.md --template 我的模板.docx - 一键转换，直接套用你的模板样式
就这么简单，无需配置，无需学习，开箱即用。
5. 效果展示
转换前：
- Markdown文档无样式、表格结构混乱、图片引用路径断裂
转换后：
标题层级自动识别- 表格保持合并单元格、全边框样式
- 图片按文档顺序正确插入
- 套用专业模板，格式统一规范
6. 最让我满意的三个设计
- 智能标题推断 - 不再需要手动设置层级，工具自动识别
- 图片完美处理 - 解决了图片顺序错乱的痛点
- 自定义模板 - 真正满足团队协作的个性化需求
- 文字版pdf支持 - 支持对文字版pdf进行转换，保留图片和表格，并清洗文本，推断标题
- 版本管理 - 保留历史转换版本并按版本管理规范命名
后续优化方向：
- 增加更多行业专属模板
- 支持更灵活的样式映射规则
- 优化大文件转换速度
7. 写在最后
做这个Skill的初衷，就是想解决自己在团队协作中遇到的格式焦虑。
没想到越做越发现，这是很多人共同的痛点。
希望这个工具能真正帮到大家，让文档处理更高效、更省心。把时间花在内容创作上，而不是和格式较劲。
在线体验： https://www.windwave.fun
GitHub地址： GitHub - wonphen-coder/document-reformatter: A document formatting tool for converting Markdown/PDF/DOCX to styled DOCX with templates · GitHub
标签： Skill创作 #效率工具 #文档处理