convert-url-html-to-md

用途

convert-url-html-to-md 用于把 HTML 网页转换为 Markdown，适合从网站抓取文档、提取结构化内容的场景。

主要能力与两阶段工作流

该技能通过两阶段方式实现较完整的文档收集：

• 发现阶段（clean=false）：获取包含导航和侧边栏在内的完整页面，用于发现所有文档 URL。
• 提取阶段（clean=true）：从已发现的 URL 中提取主体内容。

默认模式为 clean=true。

使用方式

进入技能目录：

cd ~/.claude/skills/convert-url-html-to-md

clean 模式，仅主体内容（推荐用于文档）：

node scripts/convert_url.js <url> --clean=true

完整页面模式，包含导航/侧边栏（用于发现 URL）：

node scripts/convert_url.js <url> --clean=false

默认即为 clean=true：

node scripts/convert_url.js <url>

示例：

# 获取文档站点的所有导航链接
node scripts/convert_url.js https://ui.shadcn.com/docs --clean=false

# 提取特定文档内容
node scripts/convert_url.js https://ui.shadcn.com/docs/components/radix/aspect-ratio --clean=true

安装

依赖已包含，执行一次：

cd ~/.claude/skills/convert-url-html-to-md
npm install

输出

脚本将 Markdown 直接输出到 stdout，如有需要可重定向到文件：

node scripts/convert_url.js <url> --clean=true > output.md

来源说明

该技能基于 Lee Hanken 的 urltomarkdown（MIT 许可），由 1naichii 修改并适配为 Claude 技能。

限制

资料未提供支持的具体平台范围、性能表现或错误处理细节，暂未提供。