它解决什么问题
把一份 Word 报告、一个 PDF 说明书、一张 PPT 整理进 Markdown 笔记，手动复制粘贴既慢又会丢格式。MarkItDown 把这件事变成一句话：
- 同事发来的
.docx需求文档 → 秒变 Markdown，方便贴进笔记 / 喂给 AI； - 一份几十页的 PDF 说明书 → 提取成结构化 Markdown，保留标题层级；
- 一篇不错的网页文章 → 直接抓成 Markdown 存档，告别排版混乱的复制。
盖格式「全」这一个字——几乎所有常见文档格式它都能吃。
核心特性
- 格式覆盖最全：Word / PDF / PPT / Excel / 图片 / HTML / 网页 URL 等，开箱即用；
- 命令行 + 图形界面：双击图标拖文件即转，或终端里批量处理；
- 拖放即转：把文件或网页地址拖进窗口松开，自动填入并立即转换；
- 网页转换：直接给个网址，把网页正文转成 Markdown；
- 扫描件 OCR：接 Azure Document Intelligence，处理扫描版 / 图片型 PDF（仅命令行）；
- 轻量安装：安装包约 0.6MB，免管理员、自动加入 PATH 与开始菜单。
支持的格式
安装时默认带上所有格式支持，常见输入包括：
.docx · .doc · .pdf · .pptx · .ppt · .xlsx · .xls · 图片（.jpg/.png 等）· .html · 网页 URL · 以及 XML / JSON / CSV / 音频转写等。基本上你能想到的办公文档，它都能转。
图形界面（GUI）怎么用
装完后双击桌面或开始菜单的 MarkItDown 图标即可打开，全程没有命令行黑窗口。界面要点：
- 拖放转换：文件或网页地址直接拖进窗口，松开即转，最省事；
- 输入来源：填文件路径，或勾选「URL」填网页地址；
- 输出文件：留空只预览不写盘，填了路径就保存成
.md； - 暗色 / 亮色主题：标题栏 ⚙ 设置里切换；
- 无边框窗口：拖标题栏移动、拖边缘缩放、双击标题栏最大化。
所有常用参数都在主界面上，不用记命令。
命令行（CLI）速查
新开一个终端，命令是 py-tools-markitdown（参数原样透传给 markitdown）：
:: 把 Word 文档转成 Markdown，结果输出到屏幕
py-tools-markitdown 报告.docx
:: 输出到指定文件
py-tools-markitdown 报告.pdf -o 报告.md
:: 把一篇网页转成 Markdown
py-tools-markitdown https://example.com/article -o page.md
:: 用 Azure Document Intelligence 处理扫描件（OCR）
py-tools-markitdown -d --doc-intel-endpoint <Endpoint> --doc-intel-key <Key> 扫描件.pdf -o 扫描件.md
:: 查看完整帮助
py-tools-markitdown --help| 参数 | 命令行选项 | 说明 |
|---|---|---|
| 输入来源 | SOURCE（位置参数） | 文件路径或网页 URL |
| 输出文件 | -o, --output | 留空只预览 |
| Document Intelligence | -d, --use-doc-intel | 扫描件 / OCR（仅命令行） |
| 插件转换器 | -p, --enable-plugins | 启用插件式转换器 |
| 详细日志 | -v, --verbose | 输出详细日志 |
扫描件 / OCR：什么时候用 Document Intelligence
普通「文字型」PDF / 图片里的文字，markitdown 直接能提取。但扫描版 PDF、纯图片型文档本质上是图片，需要 OCR 才能拿到文字——这时接 Azure Document Intelligence（微软云 OCR 服务）即可。配置好后加个 -d 参数就行。
需要自己有 Azure 的 Endpoint 和 Key，或在命令行用 --doc-intel-endpoint / --doc-intel-key 传入（也支持环境变量 DOCUMENT_INTELLIGENCE_ENDPOINT / DOCUMENT_INTELLIGENCE_KEY）。
下载与安装
- 点上方「下载安装包」按钮，得到
py-tools-markitdown-setup-1.0.0.exe； - 双击运行，按提示下一步——免管理员，装到当前用户目录，自动加入开始菜单和 PATH；
- 想用图形界面：双击桌面或开始菜单的 MarkItDown 图标；
- 想用命令行：新开终端输入
py-tools-markitdown。
首次启动会在窗口里显示环境初始化进度（约 1~3 分钟），完成后即可使用。之后再装本系列的 AnyDoc、BrowserUse 会自动复用这套环境，很快。
常见问题
- 图形界面打不开？依赖系统 WebView2 运行时（Win10 / Win11 通常自带）。缺失时安装 WebView2 Runtime 即可。
- PDF 里的图片提不出文字？文字型 PDF 直接能转；扫描件请配合 Document Intelligence。
- Document Intelligence 报缺少 endpoint / key？用命令行参数传入，或设置环境变量。
- 和 AnyDoc 有什么区别？MarkItDown 格式更全、支持网页和 OCR；AnyDoc 更快更轻、但不支持网页与 OCR。详见系列落地页的对比。
总结
如果你经常要把各种格式的文档、网页整理成 Markdown——喂给 AI、存进笔记、做知识库——MarkItDown 是覆盖面最广的一把刀。图形界面拖一下就能用，命令行也能塞进自动化流程。免费、轻量、装上不占地方。