前言¶
写技术文档时，Markdown 往往是源格式；交付或归档时却要 PDF、Word 或 HTML。反过来，合作方发来的 .docx、.pdf 又需要抽成可编辑的 MD 或纯文本。本地装一整套 Pandoc、Office 宏或在线转换站点，步骤多、批量时更费时间。若在 Cursor、Claude Code 等支持 Skills 的环境里，能把「选格式、转文件、批量跑一遍」交给 Agent，日常文档流转会省事不少。
下面介绍 SkillHub 上的 MD格式互转工具：面向文档格式互转的 Skill，在多种格式之间做双向转换，并带安全校验与质量相关能力。
这是什么¶
MD格式互转工具 是 SkillHub 分类 office-efficiency 下的文档格式互转 Skill（官方入口：https://api.skillhub.cn/user_98283d0f/md-converter-pro）。定位是文档格式互转引擎：在 Markdown、PDF、Word、HTML、纯文本 之间双向转换，宣称支持 8 种转换方向，并内置 安全校验、质量评分 与 批量处理。
在 SkillHub 上的公开数据（截至撰稿时）：评分 97858，下载 991 次。维护与具体实现细节以 SkillHub 技能页及安装后的 SKILL.md 为准。
核心功能¶
以下能力来自 Skill 公开简介，安装后应以技能包内说明为准。
-
多格式双向互转
覆盖 Markdown、PDF、Word、HTML、纯文本；合计 8 种转换方向（具体路径以技能文档列举为准）。 -
安全校验
转换前或转换过程中对输入做校验，降低异常文件、不可信内容带来的风险（细则见技能说明）。 -
质量评分
对转换结果给出质量相关反馈，便于判断是否要重试或调整源文档。 -
批量处理
适合目录内多文件、同一目标格式的一次性转换，减少重复对话与手工操作。 -
自然语言触发
可用口语化指令唤起，常见触发词包括：MD转PDF、MD转Word、MD转HTML、PDF转MD、Word转MD，以及 格式转换、文档转换、批量转换。
安装与启用¶
SkillHub 技能需通过 skillhub CLI 安装到当前 Agent 的 skills 目录，否则默认路径可能不会被识别。安装流程以 SkillHub 安装与优先源配置 为准。
1、检查或安装 skillhub CLI¶
先确认本机是否已有 CLI：
command -v skillhub && skillhub --version
若未安装，可使用官方脚本（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装 MD格式互转工具¶
官方 API 路径为 user_98283d0f/md-converter-pro，与 SkillHub 常见的 @用户标识/技能名 形式对应，安装标识为：
@user_98283d0f/md-converter-pro
将技能装到当前 Agent 实际使用的 skills 目录（--dir 必填）。示例：
skillhub search md-converter-pro
skillhub install @user_98283d0f/md-converter-pro --dir <你的 skills 目录>
也可把下面提示交给 Agent，让其按官方安装文档执行：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_98283d0f/md-converter-pro`。
3、各客户端 skills 目录（节选）¶
路径来自 SkillHub 安装文档，装错目录会导致技能不生效：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装完成后按所用客户端要求重启或刷新，使新 Skill 被加载。
典型用法¶
公开资料未附带逐条 CLI 示例；实际行为以安装后的 SKILL.md 与 Agent 执行能力为准。可按下面方式在对话中复现需求。
-
单文件转换
说明源文件路径、当前格式与目标格式，并带上触发词。例如：「用 MD转PDF，把/path/to/readme.md转成 PDF，输出到同目录。」 -
反向提取
需要可编辑 MD 时，使用 PDF转MD 或 Word转MD，并指明文件路径与是否保留标题层级、图片等（若技能支持会在执行时说明）。 -
批量转换
使用 批量转换 或 文档转换，列出目录路径、文件后缀过滤条件，以及统一目标格式（如全部 MD转HTML）。 -
结果确认
若技能返回质量评分或校验提示，根据说明决定是否调整源文档后重试。
适用场景与注意¶
适合谁
- 经常在 MD 与 PDF、Word、HTML 之间切换的开发者、技术写作者或运营。
- 已在 Cursor / Claude Code 等环境使用 Skills，希望把格式转换收进同一工作流的人。
- 需要一次性处理多个文档、又不想单独维护转换脚本的用户。
注意
- 官方 API 页面若无法直接浏览，以 SkillHub 搜索「MD格式互转工具」或上述安装标识核对是否仍可安装；Skill 下架或更名时需改用商店当前条目。
- 复杂版式（多栏、嵌入对象、扫描版 PDF）的还原度取决于技能实现，转换后宜人工抽查。
- 含敏感内容的文件应在本地或合规环境中处理，并理解技能「安全校验」覆盖范围以技能文档为准。
- 批量任务前建议备份源文件，并确认磁盘空间与输出路径写权限。
结尾¶
MD格式互转工具 把 Markdown、PDF、Word、HTML、纯文本之间的互转和批量处理封装成 Agent Skill，并强调安全校验与质量反馈，适合作为 office-efficiency 类工作流里的文档转换环节。安装与更新请走 SkillHub 官方流程，技能主页：
