All to Markdown

All to Markdown

基于 Microsoft MarkItDown，将任意格式的文件或 URL 转换为 Markdown，便于 LLM 分析和处理。

支持格式

前置要求

安装 markitdown：

pip install 'markitdown[all]'

给 AI 的使用说明

当用户需要将文件或 URL 转换为 Markdown 时，使用以下命令：

scripts/run.sh <文件路径或URL>

可选标志：

• -o <输出文件> — 保存到文件
• --use-plugins — 启用插件（如 markitdown-ocr）

重要原则：

• 转换结果直接输出到 stdout，可供 AI 直接读取分析
• 文件路径使用用户提供的实际路径，不要假设
• 转换大型文件时提前告知用户可能需要较长时间

使用示例

示例 1：转换 PDF

用户：帮我把这个 PDF 转成 Markdown，以便我分析内容

AI 执行：

scripts/run.sh /path/to/document.pdf

示例 2：转换并保存

用户：把这个 Excel 转成 Markdown 文件保存

AI 执行：

scripts/run.sh /path/to/data.xlsx -o output.md

示例 3：转换网页

用户：把这篇文章转成 Markdown

AI 执行：

scripts/run.sh https://example.com/article.html

示例 4：提取 YouTube 字幕

用户：把这个 YouTube 视频的内容提取出来

AI 执行：

scripts/run.sh https://www.youtube.com/watch?v=xxx

可选 AI 增强功能

设置 OPENAI_API_KEY 后，markitdown 可对图片生成 AI 描述：

OPENAI_API_KEY=sk-xxx scripts/run.sh image.jpg

安全说明

• 仅在本地执行文件转换，不发送文件内容到远程服务
• 转换 URL 时会访问对应网络地址
• 启用 LLM 功能时，图片内容会发送到 OpenAI API