什么是Markdown.new Skill
Markdown.new Skill 是一个面向开发者和 AI 工作流的网页内容转换工具，作用很明确：把公开可访问的网页 URL 转成更简洁、适合大模型处理的 Markdown。它并不是通用的网页采集平台，也不是内容管理系统，而是围绕“把页面变成 LLM 更容易消费的文本”这一目标展开。对于需要把网页送去做摘要、知识整理，或进一步进入 RAG 索引流程的场景，这类能力很实用，因为原始 HTML 往往噪声多、结构复杂，直接喂给模型既浪费上下文，也不利于稳定提取关键信息。
从使用方式看，这个 Skill 既提供脚本调用，也对应 markdown.new 的接口能力。常见流程是先确认目标链接属于公开的 http 或 https 页面，再用脚本优先以 auto 模式抓取；如果页面内容高度依赖 JavaScript 渲染，第一次结果不完整，再改用 browser 模式补抓。这样的设计说明它并不追求“一次请求解决所有页面”，而是更强调在速度、兼容性和结果完整度之间做实际权衡：普通页面先走更快的自动路径，遇到前端渲染较重的站点，再切换到无头浏览器方式。
它的价值也体现在输出形式上。转换后的内容会以 Markdown 交付，更容易进入后续的文本摘要、切片、嵌入和索引链路。工具还支持按需保留图片链接，但默认并不鼓励无差别带上图片，这反映出它主要服务的是文本处理任务，而不是网页视觉还原。与此同时，返回过程里还会暴露一些元数据，例如 token 相关信息和剩余调用额度，这对需要规划批量处理任务、控制请求节奏的自动化流程尤其重要。
需要注意的是，这个工具的边界写得很清楚：它面向公开页面，遇到 429 应视为限流，且转换结果不能被视为对所有网页都绝对完整、绝对准确。对于关键信息提取，仍然需要复核。此外，使用时还应遵守 robots.txt、服务条款与版权约束。换句话说，Markdown.new Skill 更像是一个面向工程流程的“网页转 Markdown 基础环节”，它能显著减少 HTML 清洗和格式整理的工作量，但不替代内容核验和合规判断。
核心功能特点
- 将公开网页 URL 转换为适合大模型消费的 Markdown，便于摘要、切片和索引处理
- 默认先用 auto 模式获取最快可用结果，遇到依赖 JavaScript 的页面可切换 browser 模式补抓
- 支持通过参数决定是否保留图片链接，适合在纯文本优先与信息完整之间按需取舍
- 可使用脚本、本地命令或接口方式接入自动化流程，其中 POST 模式更适合显式传参
- 能够返回 token、剩余限额等响应元数据，方便批处理任务做节奏控制与后续规划
适用场景
最直接的适用场景是 AI 内容处理前置环节。很多团队在做网页摘要、竞品信息归纳、新闻监测或知识库整理时，第一步都会遇到同一个问题：网页原始结构太杂，广告、导航、脚本和样式信息会干扰模型理解。把公开链接先转成 Markdown，再交给大模型生成摘要或提取要点，通常比直接处理 HTML 更稳，也更节省上下文。对于需要把网页内容进一步写入向量库、建立检索增强生成能力的系统，这类中间层工具尤其合适，因为它能先把页面整理成更适合切块和索引的文本形态。
它也适合做半自动或全自动的资料采集链路。比如运营、研究或产品团队需要定期收集若干公开页面内容，并交给下游程序做归档、分类或比对，这时可以优先用 auto 模式批量处理，在发现某些站点内容缺失时，再对特定页面改用 browser 模式。工具提供的元数据还能帮助任务编排系统感知请求消耗和额度余量，从而决定是否降速、分批，或延后执行。这种“先快后补”的策略，对于既要控制资源又要兼顾结果可用性的内部流程比较实用。
如果场景更偏向工程集成，这个 Skill 也适合作为“网页转文本”能力嵌入现有脚本或服务中。它既支持命令行，也支持接口调用，其中 POST 方式参数更明确，适合接入后端任务、爬取调度或 AI Agent 流水线。需要强调的是，它并不适合处理非公开页面，也不应被当作完全可靠的网页复刻工具来使用。对于法律、商业或研究上要求很高的关键提取任务，仍应保留人工复核步骤，特别是在页面复杂、强依赖前端渲染或存在限流约束时，更需要把它看作一个高效但有边界的内容预处理组件。