Agent Skills
返回列表
Markdown 转换器

Markdown 转换器

办公效率 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @zcwl/markdown-converter。

技能介绍

要解决的问题

在文档处理流程中，经常需要把 PDF、Word、Excel、PPT 等非结构化或半结构化文件转成 Markdown，以便进入 LLM 管线、静态站点生成或版本控制。传统做法往往需要先安装 Python 环境、配置依赖，且不同格式的解析规则各异，容易破坏原文的标题层级、表格和列表结构。

核心工作方式

该技能通过 uvx markitdown 直接执行转换，无需预装依赖。它覆盖了常见的办公文档、网页与数据格式，以及媒体文件：

  • 办公文档：PDF、.docx、.pptx、.xlsx/.xls
  • 网页与数据：HTML、CSV、JSON、XML
  • 媒体与其他：图片（EXIF + OCR）、音频转录、ZIP 遍历、YouTube URL、EPub

转换过程中，输出会尽量保留原文档的结构，包括标题、表格、列表和链接。首次运行时 uvx 会缓存依赖，后续调用速度会更快。对于提取效果不佳的复杂 PDF，文档建议通过 -d 参数接入 Azure Document Intelligence 来增强解析能力。

适用边界与注意点

该技能适合快速将文件转成 Markdown 文本，但不保证所有复杂版式 PDF 都能完美还原。如果遇到排版复杂、扫描件或图表密集的文件，直接转换可能出现结构错乱或内容丢失。此时需要结合 Azure Document Intelligence 等外部 OCR/版面分析服务。另外，它主要面向文本化转换，不适合对二进制资源做深度重组。

使用场景

  • 将客户发来的 PDF 报价单批量转成 Markdown，便于导入知识库检索。
  • 把 Excel 数据表、CSV 和 JSON 配置说明统一转为 Markdown，方便在文档站展示。
  • 从包含 EXIF 和文本的图片材料中抽取说明内容，生成 Markdown 归档。
  • 将 EPub 电子书和网页 HTML 页面转为 Markdown，供 LLM 摘要使用。

适合人员

  • 需要把合同、报价单和会议纪要转成可检索文本的法务助理。
  • 要把产品手册、PPT 和 Excel 指标表整理成 Markdown 文档的解决方案顾问。
  • 处理图片说明、音频转录和网页资料，构建 RAG 语料的 AI 工程师。
  • 将 EPub、HTML 和 CSV 数据说明转换为文档站内容的技术文档工程师。