用 MarkItDown 把 PDF 和 Word 变成 Claude、ChatGPT 好读的笔记
一步一步教你用 MarkItDown。它是微软免费开源的小工具，能把 PDF、Word、PPT、Excel 变成纯文本的 Markdown。写给从没打开过「终端」的人，先讲 Mac。
从这里开始
怎么用这块画布
- 从上往下看。灰色框里是命令：复制一行，粘贴到终端，按回车。
- 「在 Mac 上装一次」只要做一次，以后只看「用起来」。
- 出了问题，看「出错了怎么办」。
MarkItDown 是什么
- 微软出的免费小工具，MIT 开源许可，GitHub 上约 19 万星（2026-10）。
- 它能读 PDF、Word、PPT、Excel、网页、CSV、EPub 等，把文字写成 Markdown：保留标题、列表和表格的纯文本。
- 它的 README 说，这个工具是为了把文档交给 AI 用，不是为了排出好看的版面给人看。
- put·here 和微软、MarkItDown 没有任何关系。
- 来源：microsoft/markitdown README（官方）https://github.com/microsoft/markitdown
Claude 和 ChatGPT 都能直接读 PDF，为什么还要转
- 一个 Markdown 文件，现在和以后的任何 AI 都能用，你自己也能打开看、动手改。
- 它比原文件小很多，一次对话里能放进更多资料。
- .md 文件可以和你的笔记放在一起，比如放进 put·here 某块画布的文件夹，反复用。
- 做完你会得到：每个转过的文档旁边，多一个 .md 文件。
在 Mac 上装一次
打开终端
- 按 Command 加空格，输入「终端」（英文系统输入 Terminal），按回车。
- 会打开一个有光标在闪的窗口。灰色框里的命令就贴在这里。
先查 Python 版本，不够才装
粘贴这一行，按回车：
python3 --version
- 显示 Python 3.10、3.11、3.12、3.13 或 3.14：可以了，直接看下一张卡。
- 显示更旧的版本、提示找不到命令，或者弹出窗口问要不要安装开发者工具：先关掉那个窗口，打开 python.org/downloads/macos，下载最新的 Python 3.14 安装包（2026-10 是 3.14.10）。打开 .pkg 一路点下去，中间会要你输 Mac 密码。装完关掉终端再打开，重新查一次。
- 为什么不装 3.15：MarkItDown 的 README 写的是支持 Python 3.10 到 3.14。
- 2026-10 在 Mac 上试过（macOS 15，本来就装了 Python 3.12）：查出来是 3.12，所以跳过了安装。python.org 的安装包没有在全新的 Mac 上试过。
- 来源：python.org（官方）https://www.python.org/downloads/macos/
建一个小文件夹，把 MarkItDown 装进去
下面两行一次贴一行，每行按一次回车。第一行在你的个人文件夹里建一个叫 markitdown 的文件夹，第二行把 MarkItDown 装进去，可能要等一会儿。
python3 -m venv ~/markitdown
~/markitdown/bin/pip install 'markitdown[all]'
- 所有东西都在这一个文件夹里。以后不想用了，删掉个人文件夹里的 markitdown 文件夹就卸干净了。
- 最后可能会提示 pip 有新版本，不用管。
- 2026-10 在 Mac 上试过（macOS 15）：装了大约 15 秒，没有报错，MarkItDown 版本 0.1.9。Linux 上也试过。
用起来
转一个文件
先输入下面这行的前半段，然后从「访达」把文件拖进终端窗口（会自动填好文件路径），再输入后半段，按回车。
~/markitdown/bin/markitdown 把文件拖到这里 -o ~/Desktop/converted.md
- 桌面上会出现一个叫 converted.md 的文件。
- 2026-10 在 Mac 上试过：一个编的 Word 文件，里面有标题、一段话和一个表格，转出来标题、段落、表格都在。
转一整个文件夹
在桌面建一个叫 to-convert 的文件夹，把文件放进去，然后粘贴：
for f in ~/Desktop/to-convert/*; do case "$f" in *.md) continue;; esac; ~/markitdown/bin/markitdown "$f" -o "${f%.*}.md"; done- 每个文件旁边都会多一个同名的 .md 文件。
- 已经是 .md 的文件会跳过，所以以后往文件夹里加了新文件，再跑一次就行。
- 2026-11 在 Mac 上试过：文件夹里放了一个 Word、一个 PDF 和一个扫描版 PDF，得到三个 .md 文件；扫描版那个是空的（见「它做不到的」）。同一行又跑了第二次：还是三个 .md 文件，没有重复转换。
交给 Claude 或 ChatGPT
打开 .md 文件，全选复制，粘贴到下面这段提示词里。
这是我转成 Markdown 的一份文档：
<document>
把 Markdown 粘贴到这里。
</document>
先列出最重要的 5 点，每点附一句文档里的原话。然后告诉我，这份文档里缺了什么、哪里没说清楚。
- 要它附原话，回答就会紧扣文档；Anthropic 的提示词指南建议处理长资料时这样做。
- 2026-11 在 Claude 上试过：用一份编的会议纪要，5 点都附了原话，最后指出纪要里没写负责人和截止时间。
老实说
它做不到的
- 扫描版 PDF（每页是一张照片）转出来是空的，因为里面没有可读的文字。2026-10 在 Mac 上试过：一张文字图片做成的 PDF，转出来是空文件。
- 排版、颜色、字体都会丢。表格能保留，复杂的表格可能会乱。
- 普通的文件转换在你自己电脑上完成。有些可选功能会联网，比如 YouTube 链接和微软 Azure 服务，其中 Azure 要花钱。
- Windows 也能用，但命令不一样；这块画布只讲 Mac。
出错了怎么办
- 提示「command not found: python3」：Python 没装好。重新装一次（见「先查 Python 版本，不够才装」），然后关掉终端再打开。
- 提示「No such file or directory」：路径不对。不要手打，重新把文件拖进终端。
- 文件名里有空格：拖进去会自动处理。如果手打路径，要用引号把路径括起来。
- 安装时提示 Python 版本太新：装 3.14（见「先查 Python 版本，不够才装」），删掉 markitdown 文件夹，重做「建一个小文件夹，把 MarkItDown 装进去」。
- 安装卡住很久或者报网络错误：多半是网络慢，换个网络或者过一会儿再贴一次第二行。
试一次和来源
转三份你常翻的文档
挑三份你经常回头看的 PDF 或 Word，按「转一整个文件夹」转好，再用「交给 Claude 或 ChatGPT」里的提示词问一个问题。
来源
- microsoft/markitdown 的 GitHub README（官方；MIT 许可；约 19 万星；2026-10 查）：能转哪些格式、安装命令、用法、支持 Python 3.10 到 3.14、安全和 Azure 说明。https://github.com/microsoft/markitdown
- python.org 的 Mac 版下载页（官方；3.14.10 发布于 2026-10；2026-10 查）。https://www.python.org/downloads/macos/
- Anthropic《Prompting best practices》（官方，Claude 文档；2026-10 查）：处理长文档时让模型先引原话。https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices
- 试步骤用的示例文件都是编的。安装和转换在 2026-10 跑过：一台 Mac（macOS 15，Python 3.12）和 Linux（Python 3.13）。没测：在全新的 Mac 上安装 Python 本身。
