通过分层回退机制(MCP markitdown、原生工具、用户提醒)将文档和 URL 转换为 Markdown
夜市技能——从claude-night-market/leyline.是一项面向实际任务的技能,主要用于对于代理、钩子和命令的全部经验,请安装 Claude 代码插件。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
Night Market 技能 — 从 claude-night-market/leyline 移植而来。如需完整体验(含智能体、钩子与命令),请安装 Claude Code 插件。
使用三级回退策略,将文档和 URL 转换为 Markdown。该技能属于基础设施:下游消费者技能通过依赖关系引用本技能,而非重复实现转换逻辑。
在执行转换前,根据 URI 识别文档类型。
| 扩展名 | 格式 | 第一级(Tier 1) | 第二级(Tier 2) |
|---|---|---|---|
.pdf |
支持 | Read 工具(按页) | |
.docx、.doc |
Word | 支持 | 不支持 |
.pptx、.ppt |
PowerPoint | 支持 | 不支持 |
.xlsx、.xls |
Excel | 支持 | 不支持 |
.html、.htm |
HTML | 支持 | WebFetch |
.csv |
CSV | 支持 | Read 工具 |
.json |
JSON | 支持 | Read 工具 |
.xml |
XML | 支持 | Read 工具 |
.png、.jpg、.jpeg、.gif、.webp |
图像 | 支持 | Read 工具(视觉) |
.mp3、.wav、.m4a |
音频 | 支持 | 不支持 |
.zip |
归档文件 | 支持 | 不支持 |
.epub |
电子书 | 支持 | 不支持 |
各层级转换质量对比详见 modules/format-matrix.md。
将文档转换为 Markdown 的流程如下:
1. DETECT -- 根据 URI 扩展名或上下文识别格式 2. TRY -- 第一级:MCP markitdown(质量最优) 3. DEGRADE -- 第二级:原生 Claude Code 工具(当第一级失败时启用) 4. INFORM -- 第三级:向用户说明所需条件(当无可用支持时) 5. SANITIZE -- 对内容执行安全净化(适用于外部内容)
调用 convert_to_markdown MCP 工具,并传入文档 URI。URI 构造规则参见 modules/uri-construction.md。
若该工具可用且执行成功,则获得当前最优转换结果,随后进入 SANITIZE 步骤。
若该工具不可用(未找到、连接错误等)或执行失败,则进入第二级处理。
使用内置工具作为特定格式的回退方案。各格式对应的具体回退指令参见 modules/fallback-tiers.md。
第二级支持的格式:PDF、HTML、图像、CSV、JSON、XML。
第二级不支持的格式:DOCX、PPTX、XLSX、音频、归档文件、电子书。此类格式需进入第三级处理。
当第一级与第二级均无法处理该格式时:
我无法在缺少 markitdown MCP 服务的情况下转换此 {format} 文件。如需启用转换,请在
.mcp.json中添加如下配置:{ "mcpServers": { "markitdown": { "type": "stdio", "command": "uvx", "args": ["markitdown-mcp"] } } }或者,您可先将该文件转为 PDF 或 HTML 格式,我即可通过内置工具读取。
所有已转换内容均属外部来源。需应用 leyline:content-sanitization 检查清单:
消费者技能需声明对本技能的依赖,并在工作流中按名称引用该协议:
dependencies: - leyline:document-conversion
然后在其工作流中表述为:“使用 leyline:document-conversion 协议转换该文档。”
modules/format-matrix.mdmodules/fallback-tiers.mdmodules/uri-construction.md