关于 markitdown
markitdown 是将本地文档转换为 Markdown 的命令行工具，适用于需要整理文档内容的用户。它通过单一命令处理 PDF、Office 文件、图片 OCR、音频转录及多种文本格式。
主要功能
- 01转换 PDF、Word、Excel 和 PowerPoint
- 02从图片提取 OCR 文本
- 03将音频转为文字
- 04转换 HTML、文本及结构化数据
- 05通过命令行输出 Markdown
适用场景
- 01将 PDF 报告转换为 Markdown
- 02提取图片中的文字
- 03把音频文件转成文字稿
- 04将电子表格或演示文稿整理为 Markdown
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/markitdown确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
assets/.gitkeepreferences/.gitkeepscripts/.gitkeep详细介绍
markitdown - 文档转 Markdown
将本地文档转换为简洁的 Markdown。一个工具即可处理 PDF、Word、Excel、PowerPoint、图像等文件。
何时使用 markitdown
| 使用场景 | 建议 |
|---|---|
| 本地文件（PDF、Word、Excel） | ✅ 使用 markitdown - 独特能力 |
| 网页 | ❌ 使用 Jina（r.jina.ai/）- 速度快 5 倍 |
| 受阻拦／反机器人网站 | ❌ 使用 Firecrawl |
| 图像 OCR | ✅ 使用 markitdown |
| 音频转录 | ✅ 使用 markitdown |
基本用法
# Local files (primary use case)
markitdown document.pdf
markitdown report.docx
markitdown data.xlsx
markitdown slides.pptx
markitdown screenshot.png # OCR
# URLs (works, but Jina is faster)
markitdown https://example.com
# Save output
markitdown document.pdf > document.md
支持的格式
| 格式 | 扩展名 | 说明 |
|---|---|---|
.pdf | 提取文本和表格 | |
| Word | .docx | 保留格式 |
| Excel | .xlsx | 将表格转换为 Markdown |
| PowerPoint | .pptx | 将幻灯片作为章节 |
| 图像 | .jpg、.png | 提取 OCR 文本 |
| HTML | .html | 简洁转换 |
| 音频 | .mp3、.wav | 语音转文本 |
| 文本 | .txt、.csv、.json、.xml | 直接传递／保留结构 |
| URL | https://... | 可用，但速度比 Jina 慢 |
基准性能（URL）
| 工具 | 平均速度 | 成功率 |
|---|---|---|
| Jina | 0.5s | 10/10 |
| markitdown | 2.5s | 9/10 |
| Firecrawl | 4.5s | 10/10 |
结论：处理 URL 时使用 Jina。处理本地文件时，markitdown 是唯一选择。
示例
# PDF to markdown (primary use case)
markitdown report.pdf > report.md
# Excel spreadsheet
markitdown financials.xlsx
# Image with text (OCR)
markitdown screenshot.png
# PowerPoint deck
markitdown presentation.pptx > slides.md
# Audio transcription
markitdown meeting.mp3 > transcript.md
与替代方案对比
| 任务 | markitdown | 替代方案 |
|---|---|---|
| PDF 文本 | markitdown file.pdf | PyMuPDF、pdfplumber |
| Word 文档 | markitdown file.docx | python-docx |
| Excel | markitdown file.xlsx | pandas、openpyxl |
| OCR | markitdown image.png | Tesseract |
| 网页 | 改用 Jina | r.jina.ai/URL（速度快 5 倍） |
markitdown 的优势：一个命令行工具即可处理所有本地文档格式，无需编写代码。
评论
支持 Markdown