MarkItDown 教程：安装、Python API 与命令行使用

MarkItDown 将日常文件转换为适合文本处理的 Markdown。偶尔处理文件可以使用在线工具，需要重复运行时可以选择本地 Python 包。

使用在线转换工具

选择不超过 20 MB 的支持格式文件，点击“转换为 Markdown”。Markdown 标签显示实际下载内容，预览标签帮助你发现标题或表格问题。确认后复制到编辑器，或下载 .md 文件。请使用 HTTPS 地址；预览阶段先用非敏感示例文件测试。

需要隐私或可重复流程时在本地运行

微软将 MarkItDown 作为 Python 库和命令行程序提供。本地安装可以让基础转换在你自己的电脑上完成。只安装需要的格式依赖即可，PDF、DOCX、PPTX 和 XLSX 扩展覆盖常见办公文档。Python 版本及安装更新请以官方 README 为准。

同时保留原件与结果

Markdown 是实用的派生文本，不应替代原始文件。请保留原件，以便核实引用、数值和阅读顺序。为 .md 文件起一个明确的名称，并在知识库中记录来源。

根据用途整理下一步

做笔记时检查标题与列表；用于搜索时确认关键词已提取；交给 AI 时移除重复页眉，并按语义分段。扫描件没有文本时，应先进行 OCR，而不是反复重试同一个文件。

pip install "markitdown[pdf,docx,pptx,xlsx]"
markitdown document.docx -o document.md

# Python API
from markitdown import MarkItDown
result = MarkItDown(enable_plugins=False).convert("document.docx")
print(result.text_content)