url-to-markdown:将网页完整保存为本地 Markdown 工具指南
浏览器收藏夹链接失效、复制粘贴导致排版混乱以及付费内容过期丢失,是日常资料收集常见的问题。url-to-markdown 是一款能够将网页内容完整抓取并转换为本地 Markdown 格式的工具。该工具支持懒加载内容提取与登录后页面保存,并能自动按域名分类归档,实现网页数据的本地化持久化管理。
01前置条件与安装
- 环境准备
确保安装 Claude Code(AI 编程助手命令行工具)与 Node.js(建议选择 LTS 版本)。 - 安装命令
执行 npx skills add https://github.com/jimliu/baoyu-skills --skill baoyu-url-to-markdown,系统将自动下载并安装工具。
02核心使用场景
- 保存技术文章(自动模式)
执行命令:
npx -y bun ~/.agents/skills/baoyu-url-to-markdown/scripts/main.ts [URL]
工具将自动加载页面、滚动触发懒加载、提取内容并保存至 url-to-markdown/[域名]/ 目录,文件头部自动包含标题、作者及发布时间等元数据。 - 保存需登录内容(等待模式)
执行命令并添加 --wait 参数:
npx -y bun .baoyu-skills/baoyu-url-to-markdown/scripts/main.ts [URL] --wait
工具会打开浏览器,待用户手动完成登录及页面加载后,在终端按 Enter 键即可捕获当前页面状态。 - 批量归档页面
使用 && 连接多个命令实现批量抓取,例如:
npx -y bun ~/.agents/skills/baoyu-url-to-markdown/scripts/main.ts [URL1] && npx -y bun ~/.agents/skills/baoyu-url-to-markdown/scripts/main.ts [URL2]
生成的文件将自动按域名建立文件夹分层存储。
03笔记软件集成
生成的 Markdown 文件可直接导入主流笔记软件。在 Obsidian 中,可直接将保存文件夹拖入笔记库,或使用 -o 参数指定保存路径;在 Notion 中,可通过“导入”功能选择 Markdown 文件。文件头部的元数据便于利用 Dataview 等插件进行日期筛选或建立内容关联。
当前文章无评论,是时候发表评论了