核心用法
baoyu-url-to-markdown 是一款基于 Chrome DevTools Protocol (CDP) 的网页转 Markdown 工具，专为需要将现代动态网页归档为可阅读、可编辑格式的用户设计。用户只需提供目标 URL，工具便会启动 headless Chrome 实例，完整渲染 JavaScript 驱动的内容，最终输出包含 YAML 前置元数据的 Markdown 文件及原始 HTML 快照。
显著优点
1. 真渲染能力：不同于纯静态 HTML 抓取工具，本技能通过 CDP 驱动完整 Chrome 浏览器，确保 React、Vue 等 SPA 框架渲染后的内容被正确捕获，Shadow DOM 内容也会被序列化处理。
2. 智能转换管道：采用 Defuddle 作为首选转换引擎，针对 YouTube 等平台实现了专用提取器，可直接嵌入视频转录文本；当 Defuddle 处理失败或输出质量不佳时，自动回退至基于 Readability 的遗留管道，形成双重保障。
3. 灵活捕获模式：支持「自动捕获」（network idle 触发）和「等待模式」（用户确认后捕获），后者完美解决需要登录、懒加载或付费墙的场景。
4. 媒体本地化：可选下载图片、视频到本地目录并重写 Markdown 链接，避免外链失效风险，适合长期存档需求。
5. 多重降级机制：本地浏览器捕获失败时，可回退至托管的 defuddle.md API，最大限度保证任务完成率。
潜在局限
- Chrome 依赖：必须安装 Chrome 或 Chromium，且不同系统路径配置可能增加上手成本。
- 资源消耗：每次抓取启动完整浏览器实例，频繁操作或大规模批处理时内存和 CPU 占用较高。
- 网络超时：默认 30 秒超时对极慢网站可能不足，需手动调整。
- API 隐私：使用托管降级服务时，URL 数据会发送至第三方服务器，敏感内容需谨慎。
适合人群
- 知识管理用户：将优质长文、文档归档至个人笔记系统（如 Obsidian、Notion）
- 内容创作者：采集参考资料、保存 YouTube 视频文字记录
- 开发者/研究员：需要结构化保存技术文档、API 说明
- 归档爱好者：建立本地网页备份库，防止链接腐烂
常规风险
- 配置覆盖风险：EXTEND.md 首次设置时若未询问用户直接写入默认值，可能导致与预期不符的媒体下载行为（文档已明确禁止此做法）。
- 存储膨胀：开启媒体下载后，图片视频积累可能快速占用磁盘空间。
- 动态内容遗漏：部分重度交互页面（需滚动触发的无限列表）可能在单次捕获中无法完整抓取。