ARTICLE · 1128761
WorkBuddy 技能 17|文档转 Markdown,PDF 课件网页一键变纯文本
导语 你有没有过这种时候。下载了一篇论文 PDF，想摘两段进笔记，复制出来全是乱码和断行。或者一份课件 PPT，想改成自己的讲义，得一段一段手敲。资料就在眼前，却像被锁在格式里，拿不出来。 这篇要讲的技能叫"文档转 Markdown"，背后是微软开源的 MarkItDown。它干的事很单纯，把花里胡哨的排版扒掉，只留干净的文字骨架。你给一份 PDF、课件或者网页，它还你一份能随手复制、能喂给 AI 接着用的纯文本。不夸大，不虚构。
· · · · ·
01它是什么，一个文档翻译官
它叫 MarkItDown，微软开源的一个小工具，免费，能在本机跑，默认不上传你的文件。说白了，它就是个"文档翻译官"。你扔给它一份排版花哨的 PDF，它吐出一份干干净净、只剩文字骨架的 Markdown。配色、版式、图片框，它一律扒掉，只把字和你标的层级留下来。
输出是 Markdown，纯文本，不是新的排版文件。这一点要记牢，后面讲它能帮和帮不了什么，都绕不开它。
· · · · ·
02它怎么帮你，八种格式一口吞
它能吃下的格式有八种：PDF、Word、PPT、Excel、图片、音频、网页、YouTube 视频。前面四类是办公最常见的，后四类很多人没想到，图片里的字它能 OCR 认出来，音频和视频它能转写成文字。
用法就三种
第一，命令行一行搞定：markitdown 课件.pptx -o 课件.md。第二，网址直接转：把链接喂给它，网页秒变 Markdown。第三，写代码调用：几行 Python 就能把它集成进你自己的流程。一堆文件要转，它自带批量脚本，一条命令全处理完。
八类格式环绕 MarkItDown 引擎（示意图）
场景很好想。论文 PDF 想摘段，不用再和复制乱码搏斗。课件 PPT 想改成讲义，转完就是现成的文字稿。网页资料想存档，转完丢进笔记就能搜。图片里的文字，也能一键抠出来。
· · · · ·
03跑一个例子，拿教材样章试给你看
我们拿一份商务英语教材样章试了一次，里面有标题层级、项目符号、还有一张词汇表，跟你平时见的课件一个样。命令就一行：markitdown 样章.docx -o 样章.md。
转前 vs 转后（效果示意，演示实例）
转出来长这样：一级标题变成 #，二级标题 ##，项目符号变成 *，词汇表变成规整的 | 表格。整页结构一眼看清，复制哪段都干净。
有一处要老实说。词汇表第一行是空的，这是样章用的表头样式在识别时的小瑕疵，不是工具坏了，内容一行没丢。我们挑了最贴读者的教材样章，做了一次真实转换，不拿修饰过的图来充数。
转完这份 Markdown 能直接丢进笔记、丢进资料库，或者喂给 AI 接着做摘要、出题、翻译。资料从"锁在格式里"变成"随手能用"，就差这一步。
· · · · ·
04从哪儿用
入口：它已经装在你的 WorkBuddy 技能库里（markitdown-skill，带文档和批量脚本）。对话里说"帮我把这份 PDF 转成 Markdown"，就能把它叫出来，不用另外下载。
自己装：pip install 'markitdown[all]'，想省空间就按格式装，比如 markitdown[pdf,docx,pptx]。
图片识字：要让它认图片里的字，得额外装 tesseract（Ubuntu 用 apt、macOS 用 brew）。全程本机跑，文件不出电脑，隐私这关放心。
· · · · ·
05几件它帮不了你的事
01丢排版。它吐出的是纯 Markdown，复杂样式、内嵌图片、配色版式全没了，只留文字骨架。要精美排版，它给不了。
02认 .docx 不认 .doc。文档里明确写支持的是 .docx，老掉牙的 .doc 没列明，别想当然塞进去。
03OCR 看图片质量。图片糊、歪、手写，识别就掉链子，清晰端正才稳。
04单向通道。它是"文档转 MD"，不能把 MD 转回 PDF、Word，那是另一类工具的事。
05转写靠模型。音频、YouTube 转写依赖语音模型，不是万能听写，专业术语照样会翻车。
· · · · ·
06结语
资料不该是"复制粘贴的噩梦"，而该是"随手就能用的文字"。MarkItDown 做的事不花哨，就是把这道扒排版的门槛压成了一行命令。骨架它给你扒好，怎么用、往哪接，是你自己的事。
飞鸿本人我在学校也常被学生问"老师这份 PDF 怎么摘不下来"，其实就是差这么一个扒排版的步骤。这个工具把步骤压成了一行命令，我看着顺手，也放心。本文对技能的描述全部来自它的官方文档，加上这次真实跑出来的转换实例，示意图就是用演示数据画的。
下期预告 技能系列继续更新，下一篇正在路上。