https://haodaohang.top/tags/markitdown/ Recent content in MarkItDown on 赛博工具站 https://haodaohang.top/images/cover.png https://haodaohang.top/images/cover.png Hugo -- 0.152.2 zh-cn Sat, 11 Apr 2026 10:00:00 +0800 https://haodaohang.top/posts/2026-04-11-markitdown-review/ Sat, 11 Apr 2026 10:00:00 +0800 https://haodaohang.top/posts/2026-04-11-markitdown-review/ <h2 id="简介">简介</h2> <p>微软搞了个Python工具，专门把各种文件转成Markdown。PDF、Word、Excel、PPT、图片、音频，扔进去就吐出Markdown。拿它喂LLM特别顺手。</p> <p>核心思路很简单：主流LLM（GPT-4o、Claude这些）都&quot;说&quot;Markdown，训练数据里大量Markdown，理解得好，token消耗还低。MarkItDown就把杂七杂八的格式统一成Markdown，让LLM更好消化。</p> <h2 id="核心功能">核心功能</h2> <ul> <li><strong>多格式支持</strong>：PDF、Word、Excel、PowerPoint、图片（EXIF元数据+OCR）、音频（语音转文字）、HTML、CSV、JSON、XML、ZIP、YouTube链接、电子书</li> <li><strong>保留文档结构</strong>：标题、列表、表格、链接都能识别，不是简单粗暴提取文字</li> <li><strong>MCP集成</strong>：内置Model Context Protocol服务器，能跟Claude Desktop这类LLM应用直接联动</li> <li><strong>插件系统</strong>：第三方插件扩展功能，比如markitdown-ocr用LLM视觉能力做OCR</li> <li><strong>Azure文档智能</strong>：可对接Azure Document Intelligence，处理复杂文档</li> </ul> <h2 id="价格方案">价格方案</h2> <table> <thead> <tr> <th>方案</th> <th>价格</th> <th>功能限制</th> </tr> </thead> <tbody> <tr> <td>开源版</td> <td>免费</td> <td>全功能，无限制</td> </tr> <tr> <td>Azure增强</td> <td>按Azure计费</td> <td>文档智能API调用量计费</td> </tr> </tbody> </table> <blockquote> <p>这个工具完全开源免费，代码托管在GitHub。唯一成本是你如果要用Azure Document Intelligence增强版，才需要按Azure的计费标准付钱。</p> </blockquote> <h2 id="优缺点对比">优缺点对比</h2> <table> <thead> <tr> <th>优点</th> <th>缺点</th> </tr> </thead> <tbody> <tr> <td>微软官方维护，质量有保障</td> <td>需要Python环境，对非技术用户有门槛</td> </tr> <tr> <td>支持格式极其全面</td> <td>某些格式（如扫描PDF）需要额外OCR配置</td> </tr> <tr> <td>输出的Markdown质量高，结构清晰</td> <td>音频转写依赖额外依赖包</td> </tr> <tr> <td>开源免费，代码可审计</td> <td>没有图形界面，纯命令行/Python API</td> </tr> <tr> <td>支持LLM图片描述功能</td> <td>文档相对简陋</td> </tr> </tbody> </table> <h2 id="适合人群">适合人群</h2> <p>推荐给：</p> <ul> <li>需要把大量文档喂给LLM的开发者</li> <li>做RAG（检索增强生成）项目的工程师</li> <li>内容创作者，想把PDF/Word转成可编辑的Markdown</li> <li>数据分析师，需要从PDF报告里提取结构化数据</li> </ul> <p>不推荐：</p> <ul> <li>寻找图形界面工具的普通用户</li> <li>只需要简单PDF转文字的场景（在线工具更快）</li> <li>对格式保真度要求极高的人（这是给LLM看的，不是给人看的精美排版）</li> </ul> <h2 id="使用教程">使用教程</h2> <h3 id="安装">安装</h3> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>pip install <span style="color:#e6db74">&#39;markitdown[all]&#39;</span> </span></span></code></pre></div><p>如果只想装特定格式的支持：</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>pip install <span style="color:#e6db74">&#39;markitdown[pdf,docx,pptx]&#39;</span> </span></span></code></pre></div><h3 id="命令行使用">命令行使用</h3> <p>最简单的方式：</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>markitdown 你的文件.pdf &gt; 输出.md </span></span></code></pre></div><p>指定输出文件：</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>markitdown 文件.docx -o 输出.md </span></span></code></pre></div><p>管道方式：</p>