url-to-markdown

URL to Markdown

概述

将网页 URL 转换为清晨的 Markdown 文档，自动下载图片到本地并更新引用，同时添加摘要、学习目标、知识图谱、FAQ 等内容增强。

使用方式

触发命令

/url-to-markdown <URL> [输出文件路径]

示例：

/url-to-markdown https://example.com/post/123
/url-to-markdown https://example.com/post/123 ./docs/article.md

工作原理

此技能通过 Commands 调用脚本执行：

1. 脚本执行：获取网页内容、转换为 Markdown、下载图片、美化格式
2. Claude 处理：按步骤生成摘要、学习目标、知识图谱、FAQ，插入到文档中

Claude 处理流程

当用户触发命令时，Claude 会按以下步骤执行：

第一步：调用脚本转换 URL 为 Markdown

python3 ${CLAUDE_PLUGIN_ROOT}/skills/url-to-markdown/scripts/url_to_markdown.py <URL> [输出文件路径]

第二步：分析文档内容

读取转换后的文档，提取：

• 主标题和章节标题
• 首个标题后的核心内容
• 文档的整体主题和难度

第三步：生成增强内容

基于文档内容生成四个板块：

摘要 - 1-3 句话概括文档主要内容

学习目标 - 3-5 个具体的学习目标

知识图谱 - Mermaid mindmap 或 flowchart 展现核心概念

常见问题（FAQ） - 3-5 个读者可能会有的问题

第四步：更新文件

现在将第三步生成的四个板块直接写入文件：

1. 确定插入位置：

   • 如果文档有 YAML frontmatter（---...---），在 frontmatter 之后
   • 如果没有 frontmatter，在文档最顶部

2. 构建完整内容：

   • 根据第三步的内容，拼接以下四个板块：
     1. ## 摘要 + 摘要内容
     2. ## 学习目标 + 学习目标列表
     3. ## 知识图谱 + Mermaid 代码块
     4. ## 常见问题 + FAQ 列表
   • 确保块之间各空一行

3. 保存文件：

   • 在确定的插入位置插入这些内容
   • 确保最后一个块和原文内容之间空一行
   • 确保文件末尾有换行符
   • 立即将修改保存到文件

第五步：完成并报告

自动检查和确认（不需要用户确认）：

1. 自动验证：

   • ✓ 所有增强内容都基于文档实际内容
   • ✓ 没有重复的摘要（如已有概述则已跳过）
   • ✓ Markdown 格式正确无误
   • ✓ 文件末尾有换行符

2. 生成完成报告（直接显示，无需询问）：

   • 📝 列出已插入的五个内容块
   • 🖼️ 报告已下载的图片数量和更新情况
   • ✅ 确认文件已保存的路径
   • 📊 简要说明增强内容的质量检查结果

重要：不要询问用户是否需要"预览"或"diff"，直接完成并显示简明报告即可。

功能说明

1. 网页获取：从 URL 获取网页内容
2. Markdown 转换：将 HTML 转换为清晰的 Markdown 格式
3. 创建 img 文件夹：在 Markdown 文件同目录下创建 img 文件夹
4. 下载图片：提取并下载所有图片到 img 文件夹（使用 MD5 哈希命名）
5. 更新引用：将图片引用更新为本地路径 ./img/filename.jpg
6. 美化格式：标题空行、列表规范化、删除多余空行等
7. 内容增强：基于文档内容自动生成：
   • 摘要、学习目标、知识图谱、FAQ

脚本说明

Commands 自动执行以下脚本：

# 1. 获取网页并转换为 Markdown
python3 ${CLAUDE_PLUGIN_ROOT}/skills/url-to-markdown/scripts/url_to_markdown.py <URL> [输出文件路径]

# 2. Claude 按步骤生成增强内容（摘要、学习目标、知识图谱、FAQ）
# 并插入到文档顶部

# 3. Claude 检查和保存

依赖

pip install requests beautifulsoup4 html2text

手动运行脚本

# 脚本位置
ls -la skills/url-to-markdown/scripts/

# 方式1：完整流程（转换 + 增强）
python3 ${CLAUDE_PLUGIN_ROOT}/skills/url-to-markdown/scripts/url_to_markdown.py <URL> [输出文件路径]
python3 ${CLAUDE_PLUGIN_ROOT}/skills/markdown-organizer/scripts/enhance_content.py --enhance <输出文件路径>

# 方式2：仅转换网页
python3 ${CLAUDE_PLUGIN_ROOT}/skills/url-to-markdown/scripts/url_to_markdown.py <URL> [输出文件路径]