前言¶

把一份 Word 报告、Excel 台账或 PDF 说明书喂给模型之前，往往要先花时间做格式清洗：去掉页眉页脚、样式标记、合并单元格带来的错位，把表格还原成文本。用脚本解析能解决一部分，但遇到 docx 的富文本、xlsx 的多 sheet、pdf 的版面，任何一套 parser 都有覆盖不到的地方，最后要么漏掉结构，要么留下一堆噪声。

下面介绍的这个 Skill 走了另一条路线：不装 parser，直接把转换规则交给模型完成，让它按 markitdown 的输出风格把内容整理成干净 Markdown。

这是什么¶

Skill 名称：任意内容转干净 Markdown（markitdown 哲学）。

这是 SkillHub 上的一条 community 来源 Skill，坐标 @user_00c9b356/chenlin-markitdown-converter-zh，版本 1.0.0，分类 office-efficiency，发布者 user_00c9b356。

它解决的问题是：把 docx、xlsx、html、csv、json、pdf 文本等格式转换为 LLM 友好的 Markdown，保留标题、列表、表格、链接结构，丢弃排版与样式噪音。

官方地址：

https://api.skillhub.cn/user_00c9b356/chenlin-markitdown-converter-zh

SkillHub 页面：

https://www.skillhub.cn/skills/user_00c9b356/chenlin-markitdown-converter-zh

核心功能¶

它的能力边界写在简介里，只做三件事：

1. 格式感知转换：识别输入是文档、表格、网页还是结构化文本，按各自特点整理，而不是用同一套逻辑硬切。
2. 结构保留：标题层级、列表、表格、链接会被还原成 Markdown 语法，让模型读起来像读一篇结构化文档。
3. 样式丢弃：字体、颜色、页边距、批注、样式标记这类与语义无关的信息不进入输出。

它的实现取向在名字里就写明了：零解析器，纯模型转换。也就是说，转换不依赖针对某种格式的专用库，转换质量取决于模型对结构的理解，而不是 parser 的覆盖范围。

打标情况如下：

requires_api_key = false

即不需要额外配置 API Key，直接在已有模型会话里使用。

安装与启用¶

这里如实说明：官方资料里没有给出具体安装命令，也没有列出目录或配置项。这份 Skill 基于通用 SKILL.md 格式，属于 community 来源，使用前需要按官方页面的说明把它放进所用 agent 的 skill 目录。

以官方页面说明为准：
https://www.skillhub.cn/skills/user_00c9b356/chenlin-markitdown-converter-zh

由于资料中没有 Cursor、Codex CLI、Claude Code 各自的安装方式说明，这里不做区分，也不推测命令写法。如果你所在环境的 skill 加载路径和上面页面不一致，以页面为准。

典型用法¶

官方资料没有给出可复现的示例或参数说明，下面只描述它的预期用法，供你判断是否适合自己。

1. 准备输入：一份待转换的 docx、xlsx、html、csv、json 或 pdf 文本。
2. 触发转换：把内容交给这个 Skill，让它按 markitdown 风格输出 Markdown。
3. 拿到结果：输出是带标题、列表、表格、链接的干净 Markdown，可以直接作为模型的上下文。

需要留意的是，这是纯模型转换，输出不是确定性的：同一份输入在不同模型或不同调用下，标题层级、表格列顺序的还原程度可能有差异。如果你的流程要求转换结果严格可复现，这种方案不如固定 parser 稳。

适用场景与注意¶

适合的场景：

• 内容格式杂，不想为每种格式维护一套解析脚本。
• 输入是一次性的文档或报告，转换质量取决于语义理解，而不是字节级一致性。
• 主要目标是让模型读懂结构，排版还原不是硬需求。

需要注意的限制：

• 纯模型转换，速度和成本取决于模型调用，批量处理大量文件时要先算一下开销。
• 没有 parser 兜底，遇到扫描件 pdf（图片型）这类没有文本层的内容，转换不出结构。
• 表格转换可能改变合并单元格、跨行跨列的语义，需要在下游再校验一次。
• 页面统计数字会变化：抓取时的资料口径是评分 100000、下载 1829、安装 0，使用前以官方页面实时数据为准。

结尾¶

这个 Skill 的价值在于把格式清洗这一步统一成「交给模型按 markitdown 风格整理」，省掉针对不同格式写解析逻辑的成本，代价是转换结果不是确定性的。适合格式多样、单次转换、对语义结构有要求的场景。

官方地址：

https://api.skillhub.cn/user_00c9b356/chenlin-markitdown-converter-zh