mcpField
C
convert-url-html-to-md

convert-url-html-to-md

github.com/1naichii文档处理44 次安装
代码仓库

关于 convert-url-html-to-md

将网页 HTML 转为 Markdown 的 Claude 技能，采用两阶段流程：先从完整页面发现文档链接，再提取页面主体内容。转换结果输出到标准输出。

主要功能

  1. 01从完整页面发现文档链接
  2. 02以清理模式提取主体内容
  3. 03将网页内容转换为 Markdown
  4. 04将结果输出到标准输出或文件

适用场景

  1. 01通过网站导航查找文档页面
  2. 02转换指定文档页面
  3. 03将提取内容保存为 Markdown 文件

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/1naichii/ai-code-tools --skill convert-url-html-to-md

安装后在 Claude Code 中输入/convert-url-html-to-md确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

package.json
lib/
html_table_to_markdown.js
url_to_markdown_apple_dev_docs.js
url_to_markdown_common_filters.js
url_to_markdown_formatters.js
url_to_markdown_processor.js
url_to_markdown_readers.js
scripts/
convert_url.js

详细介绍

将 URL HTML 转换为 Markdown

采用两阶段方法提取网页内容，以全面收集文档。

两阶段工作流

为获得最佳文档提取效果：

  1. 发现（clean=false）：获取包含导航栏和侧边栏的完整页面，以发现所有文档 URL
  2. 提取（clean=true）：从发现的 URL 中提取主要内容

用法

# From the skill directory
cd ~/.claude/skills/convert-url-html-to-md

# Clean mode - main content only (recommended for docs)
node scripts/convert_url.js <url> --clean=true

# Full page mode - includes nav/sidebar (for discovering URLs)
node scripts/convert_url.js <url> --clean=false

# Default is clean=true
node scripts/convert_url.js <url>

示例

# Get all navigation links from a docs site
node scripts/convert_url.js https://ui.shadcn.com/docs --clean=false

# Extract specific documentation content
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 技能。

评论

支持 Markdown