Markdown Converter 是一个将文档和文件转换为 Markdown 的命令行工具，底层使用 markitdown，通过 uvx 运行，无需安装。
用途
该工具用于把多种格式的文件转换为 Markdown 文本，适合需要将文档内容整理为 Markdown 的场景。
主要能力
支持多种格式：
- 文档：PDF、Word（.docx）、PowerPoint（.pptx）、Excel（.xlsx、.xls）
- 网页/数据：HTML、CSV、JSON、XML
- 媒体：图片（EXIF + OCR）、音频（EXIF + 转录）
- 其他：ZIP（遍历内容）、YouTube URL、EPub
输出会保留文档结构，包括标题、表格、列表和链接。
使用方式
基本用法：
转换到标准输出
uvx markitdown input.pdf
保存到文件
uvx markitdown input.pdf -o output.md uvx markitdown input.docx > output.md
从标准输入读取
cat input.pdf | uvx markitdown
选项：
-o OUTPUT # 输出文件 -x EXTENSION # 提示文件扩展名（用于标准输入） -m MIME_TYPE # 提示 MIME 类型 -c CHARSET # 提示字符集（例如 UTF-8） -d # 使用 Azure Document Intelligence -e ENDPOINT # Document Intelligence 端点 --use-plugins # 启用第三方插件 --list-plugins # 显示已安装插件
示例：
转换 Word 文档
uvx markitdown report.docx -o report.md
转换 Excel 表格
uvx markitdown data.xlsx > data.md
转换 PowerPoint 演示文稿
uvx markitdown slides.pptx -o slides.md
使用文件类型提示（用于标准输入）
cat document | uvx markitdown -x .pdf > output.md
使用 Azure Document Intelligence 获得更好的 PDF 提取效果
uvx markitdown scan.pdf -d -e "https://your-resource.cognitiveservices.azure.com/"
适用场景
适用于需要将 PDF、Office 文档、网页数据、媒体文件等转换为 Markdown 的场合，例如文档整理、内容迁移或数据预处理。
限制
首次运行会缓存依赖，后续运行更快。对于提取效果较差的复杂 PDF，可使用 -d 配合 Azure Document Intelligence。其他限制暂未提供。