- name
- miaoda-doc-parse
- description
- Use when user needs to parse, extract, or read content from documents (PDF, Word, Excel, PPT, etc.) Converts documents to Markdown via IDP (Intelligent Document Parsing). 触发词：文档解析, 解析文档, 解析 PDF, 解析 Word, 解析 Excel, 读取文档, 提取文档内容, doc parse, IDP, 智能文档解析, parse document, 文档转 Markdown, 读取 PDF, 读取 PPT, 提取表格, 文档识别
Document Parse
通过 miaoda-studio-cli doc-parse 将文档解析为 Markdown 格式（基于 IDP 智能文档解析）。
Quick Reference
| 参数 | 说明 | 必需 | 默认值 |
|---|---|---|---|
--file | 文档路径或 URL | 是 | - |
--output, -o | 输出格式: text/json | 否 | text |
支持的文档格式
| 格式 | 扩展名 | 典型场景 |
|---|---|---|
.pdf | 报告、论文、合同 | |
| Word | .doc, .docx | 文档、方案 |
| PowerPoint | .pptx | 演示文稿 |
| Excel | .xlsx | 表格数据 |
| CSV | .csv | 结构化数据 |
| 纯文本 | .txt, .md | 文本文件 |
| 网页 | .html | HTML 页面 |
使用示例
# 解析本地 PDF 文件
miaoda-studio-cli doc-parse --file report.pdf
# 解析远程文档并输出 JSON
miaoda-studio-cli doc-parse --file https://example.com/document.docx --output json
# 解析 Excel 表格
miaoda-studio-cli doc-parse --file data.xlsx --output json使用场景决策
需要获取文档内容
├─ 文档是本地文件或可下载 URL → miaoda-studio-cli doc-parse
├─ 文档是网页（需要抓取）→ miaoda-studio-cli web-crawl（见 miaoda-web-fetch skill）
└─ 文档是飞书云文档 → 使用 feishu skillCommon Mistakes
| 错误 | 正确做法 |
|---|---|
用 miaoda-studio-cli doc-parse 解析网页 URL | 网页内容用 miaoda-studio-cli web-crawl（见 miaoda-web-fetch skill） |
| 不检查文件格式是否支持 | 确认文件扩展名在支持列表中 |
需要结构化数据但未加 --output json | 需要程序处理时加 --output json |
| 文件路径包含空格未加引号 | 路径有空格时用引号包裹：--file "my file.pdf" |
| 解析飞书云文档用 doc-parse | 飞书云文档使用 feishu skill 通过 API 读取 |