用途:将多种格式文档统一转换为干净 Markdown,便于 AI 智能体读取、总结、问答或接入 RAG 流程。
主要能力:支持 PDF(pdfplumber,逐页提取文本与表格)、Word .docx(python-docx,标题、段落、表格、列表)、PowerPoint .pptx(python-pptx,逐页标题、正文与表格)、Excel .xlsx(openpyxl,每个工作表转为 Markdown 表格)、CSV(stdlib csv,首行为表头)、HTML(BeautifulSoup,去标签保留结构)、纯文本 .txt/.md/.rst(透传并轻度清理)。输出中 PDF 每页以 --- 分隔;Word 标题映射为 #/##/###;PowerPoint 每页为 ## Slide N: 标题;Excel 每表为 ## Sheet: 名称;HTML 语义标签会被转换。
使用方式:运行 convert.py,参数为输入文件,可选 --output 写入文件(默认输出到 stdout),--format json 返回 JSON(含 success、markdown、format、pages、tables)。示例:python3 skills/doc-to-markdown/convert.py report.pdf --output report.md;python3 skills/doc-to-markdown/convert.py slides.pptx --format json。
依赖:pdfplumber、python-docx、python-pptx、openpyxl、beautifulsoup4,Starchild 环境已预装,无需 API key,转换全部本地运行。
适用场景:向 LLM 提供文档内容做摘要或问答、从报告提取结构化数据、迁移旧文档、让智能体读取附件、为 RAG 预处理文件。
限制:不支持的扩展名会返回错误并列出支持格式;文件损坏或不可读会返回错误;空文件返回 success=true 的空 Markdown。其他收费、价格、平台或效果信息暂未提供。