前言¶
在 Cursor、Claude Code 等环境里做文档分析时，常见做法是手动复制粘贴，或针对 PDF、Office、网页各写一套解析脚本。格式一多，上下文里往往只剩零散摘录，难以让模型按整份材料推理。下面介绍 SkillHub 上的社区 Skill All to Markdown（@user_2c495456/all-to-markdown）：在本地通过 Microsoft MarkItDown 把文件或 URL 转成 Markdown，再交给 Agent 读取。
这是什么¶
All to Markdown 是遵循通用 SKILL.md 格式的 Agent Skill，当前版本 0.1.0，来源为 SkillHub community，发布者为 user_2c495456，分类 office-efficiency。Skill 元信息标明 requires_api_key=false；底层转换不依赖远程 API Key，可选的 OPENAI_API_KEY 仅用于图片描述、OCR 等增强能力。
一句话定位：将 PDF、Word、Excel、PPT、图片、音频、网页等输入转为 Markdown，便于 LLM 分析。维护信息见 Skill 包内作者字段（Ping Si）。
核心功能¶
以下能力均来自 Skill 包内 SKILL.md 与 scripts/run.sh 的说明。
支持的输入类型¶
| 类型 | 格式 |
|---|---|
| 文档 | PDF、DOCX、PPTX、XLSX、XLS、EPUB、MSG |
| 数据 | CSV、JSON、XML |
| 图片 | JPG、PNG 等（含 EXIF；可选 OCR） |
| 音频 | WAV、MP3（语音转录需 OpenAI Key） |
| 网页 | HTML、YouTube URL（含字幕提取） |
| 压缩 | ZIP（逐文件转换） |
运行方式¶
- 默认将 Markdown 输出到 stdout，Agent 可直接读取。
-o <输出文件>可写入磁盘。--use-plugins可启用插件（如markitdown-ocr）。- 转换 URL 时会访问对应网络地址；启用 LLM 相关功能时，图片内容会发往 OpenAI API（Skill 内安全说明）。
环境与依赖¶
- Python >= 3.10（
config.json）。 - 需安装 CLI：
pip install 'markitdown[all]'。
安装与启用¶
1. 安装 SkillHub CLI（若尚未安装）¶
按 SkillHub 安装文档 检查或安装：
command -v skillhub && skillhub --version
未安装时可执行：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安装本 Skill 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向 Agent 实际使用的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。常见路径（摘自官方安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装命令示例：
skillhub install @user_2c495456/all-to-markdown --dir ~/.cursor/skills/
SkillHub 页面亦提供等价提示：根据 https://skillhub.cn/install/skillhub.md 安装 @user_2c495456/all-to-markdown。
3. 安装 markitdown¶
Skill 不会自动执行 pip 安装（config.json 中 autoInstall: false），需自行准备：
pip install 'markitdown[all]'
安装后可用 markitdown 命令；Skill 通过 scripts/run.sh 调用该 CLI。
典型用法¶
在 Skill 目录下（或 Agent 已加载该 Skill 时），对用户提供的真实路径或 URL 执行转换，不要假设路径。
转换 PDF 并供模型分析¶
scripts/run.sh /path/to/document.pdf
转换 Excel 并保存为文件¶
scripts/run.sh /path/to/data.xlsx -o output.md
转换网页¶
scripts/run.sh https://example.com/article.html
提取 YouTube 字幕¶
scripts/run.sh https://www.youtube.com/watch?v=xxx
可选：图片 AI 描述¶
设置环境变量后执行：
OPENAI_API_KEY=sk-xxx scripts/run.sh image.jpg
查看帮助：
scripts/run.sh --help
适用场景与注意¶
适合谁
- 需要在 Agent 对话里快速「读懂」PDF、Office、表格、网页、音视频稿的开发者或写作者。
- 希望统一走 Markdown 管线，减少为每种格式单独写解析逻辑的团队。
限制与注意
- 大文件转换可能耗时较长，Skill 要求 Agent 提前告知用户。
- 音频转录、部分 OCR/图片描述依赖 OpenAI，与 SkillHub 标签「无需 API Key」指默认转换路径不同；未配置 Key 时相关能力可能不可用。
- 转 URL、YouTube 需要网络；ZIP 会按文件逐个处理，体量过大时注意时间与磁盘。
- SkillHub 页面统计（抓取时）：评分 100000，下载 574，安装 1；以页面实时数据为准。
结尾¶
All to Markdown 把 MarkItDown 的能力封装成 Agent 可执行的 Skill：本地转换、stdout 直出、覆盖常见办公与网页格式。若你正在 SkillHub 上找办公效率类 Skill，可从官方条目入手。
- SkillHub 页面：https://www.skillhub.cn/skills/user_2c495456/all-to-markdown
- API 坐标页：https://api.skillhub.cn/user_2c495456/all-to-markdown
