核心用法
!markdown-extract <url> [method] 命令可将任意网页转换为结构化 Markdown。支持三种提取策略:
- auto(默认):通过 HTTP 请求协商获取 Markdown,速度最快
- ai:调用 Cloudflare Workers AI 的
toMarkdown()进行智能转换 - browser:使用无头浏览器渲染 JS 密集型页面,完整性最佳但最慢
显著优点
- 零配置:无需 API Key,直接调用公开端点
- 多模式自适应:根据页面复杂度选择最优提取策略
- 错误降级机制:自动检测 Cloudflare 拦截并切换备选方案
- 输出纯净:返回标准 Markdown,便于下游 AI 处理或文档归档
潜在局限
- 依赖外部服务:markdown.new 为第三方服务,存在可用性风险
- 无本地缓存:重复请求相同 URL 会重复消耗网络资源
- browser 模式延迟:动态渲染需等待页面完全加载,不适合批量高频调用
- 内容策略限制:部分网站可能阻止自动化抓取
适合人群
- 需要快速提取网页正文用于 AI 摘要、知识库建设的开发者
- 研究人员进行网页内容归档和结构化整理
- 构建 RAG 系统需要清洗 HTML 噪声的数据工程师
常规风险
- 外部 API 可能记录请求 URL 及元数据,敏感页面需谨慎
- 高频调用可能触发速率限制或 IP 封禁
- 提取结果受目标网站反爬策略影响,可能出现内容截断