文档转Markdown Skill:把常见文档统一转成 Markdown

前言

做内容处理或知识库搭建的人经常遇到同一个问题:手上的文件格式五花八门,docx、pptx、xlsx、pdf、html、csv、rtf、odt、epub、txt 各有各的解析方式,每个格式都要单独写脚本或调工具,流程很难复用。下面介绍的这个 Skill 把「文档转 Markdown」这件事收敛成一个统一入口:用户给出文件并表达转换意图,Skill 负责识别格式、提取内容并输出 Markdown。图片和扫描件 PDF 则走 OCR 路线,识别后再包装成 Markdown。

这是什么

这是一个发布在 SkillHub 上的社区 Skill,坐标 @user_75a20f40/laozhuang-b06,名称为「文档转Markdown」,当前版本 1.0.0,来源标记为 community,发布者是 user_75a20f40。它解决的问题是:让大模型在对话中直接处理用户给出的多种文档文件,输出结构化的 Markdown 文本,省去为每种格式单独写解析代码的工作。

根据官方页面元数据,该 Skill 分类为 office-efficiency,不需要 API Key(标签 requires_api_key=false),即本地或已有模型环境即可运行,不需要额外申请密钥。

支持的输入与处理方式

根据官方简介,Skill 覆盖的输入类型包括:

docx、pptx、xlsx、pdf、html、csv、rtf、odt、epub、txt

触发条件是用户给出上述文件之一,并表达以下任一意图:

  1. 明确要求「转成 Markdown」
  2. 要求「提取正文」
  3. 直接说「把我这个文件变成 md」

对于图片和扫描件 PDF,Skill 本身不做 OCR,而是调用 OCR 技能识别后再包装为 Markdown。也就是说,纯图片类输入需要环境中存在可用的 OCR 能力,否则这部分功能无法直接生效。

安装与启用

抓取到的资料中没有给出具体的安装命令或目录路径,因此这里不臆造命令。SkillHub 上的社区 Skill 通常通过对应的 SkillHub 页面安装,使用前建议先打开页面确认当前版本的安装方式。

官方地址:

https://www.skillhub.cn/skills/user_75a20f40/laozhuang-b06

API 地址:

https://api.skillhub.cn/user_75a20f40/laozhuang-b06

需要注意,该 Skill 的元数据显示安装量为 0,评分为 100000,下载 889。安装量为 0 说明目前还没有公开的采用记录,社区验证有限,接入前应在自己的文档样本上先做一轮验证。

典型用法

下面是按官方简介中的触发方式组织的示例。把文件路径替换成实际文件即可复现:

把这份文件转成 Markdown:/path/to/report.docx
提取这个 PPT 的正文内容,输出 Markdown:/path/to/slides.pptx
把我这个文件变成 md:/path/to/data.xlsx

输出结果通常为一份 Markdown 文本,具体章节结构取决于源文件内容。对于表格类文件(xlsx、csv),建议确认转换后的表格是保留为 Markdown 表格还是退化为纯文本,再决定是否直接用于下游流程。

适用场景与注意事项

适合的场景:

  1. 需要把一批格式混杂的文档统一成 Markdown,再做检索、摘要或入库。
  2. 希望在对话中直接完成转换,而不是维护一套离线转换脚本。
  3. 已有 OCR 能力,需要处理扫描件和图片型 PDF。

需要注意的地方:

  1. 版本号为 1.0.0,安装量为 0,行为可能随版本更新变化,重要流程建议固定版本。
  2. 图片和扫描件依赖外部 OCR 技能,缺失时这部分输入无法转换。
  3. 表格结构(合并单元格、多级表头)在 Markdown 中的表现有限,复杂表格需要人工核对。
  4. 文档内嵌的宏、批注、样式信息不属于正文,转换后通常不会保留。

小结

这个 Skill 的价值在于把多格式文档解析这件事收敛成一句自然语言指令,覆盖 docx、pptx、xlsx、pdf、html、csv、rtf、odt、epub、txt 等常见格式,图片和扫描件走 OCR 后再包装为 Markdown。它来自 SkillHub 社区,坐标 @user_75a20f40/laozhuang-b06,当前版本 1.0.0,分类 office-efficiency,不需要 API Key。由于安装量为 0,社区验证有限,建议先在小样本上跑通再批量使用。

官方地址:https://www.skillhub.cn/skills/user_75a20f40/laozhuang-b06

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜