markdown.new URL 前缀

每当您需要访问一个网站 URL 时，您必须：

1. 将其重写为通过 https://markdown.new/ 访问，然后
2. 访问重写后的 URL，并且
3. 从该页面提取 Markdown 内容，以便在您的回答/笔记中使用。

重写规则

1. 将目标地址规范化为带有协议（首选 https://）的绝对 URL。
2. 在其前面加上 https://markdown.new/（不要去掉原始协议）。

示例

• https://example.com -> https://markdown.new/https://example.com
• https://example.com/docs?a=1#b -> https://markdown.new/https://example.com/docs?a=1#b
• example.com -> https://markdown.new/https://example.com

代理工作流程（必需）

当您通常需要打开一个网站来阅读时：

1. 生成重写后的 markdown.new URL。
2. 首先访问重写后的 URL（而不是原始 URL），但仅限于它可能有效的情况（参见下面的策略）。
3. 从 Markdown 视图（渲染后的 Markdown 和/或原始 Markdown）中提取页面内容。
4. 使用提取出的 Markdown 作为摘要、引用、清单或可复制笔记的来源。

如果 markdown.new 视图加载失败或破坏了关键功能，则回退到原始 URL 进行浏览，但在可能的情况下，仍优先使用 markdown.new 进行任何内容提取。

策略：何时使用 markdown.new（必需）

不要将每个网站都通过 markdown.new 路由。主要用于“只读”页面，您希望从中获取干净、可提取的文本：

• 文档页面
• 博客文章 / 公告 / 更新日志
• GitHub 问题/PR 讨论（当您只需要可读文本时）
• 文章和指南

当目标网站很可能被阻止或需要原始网站行为时，跳过 markdown.new 并直接访问原始 URL：

• 登录、OAuth、结账、支付或任何需要身份验证的工作流程
• 内容被 JS 应用、验证码、机器人检测或付费墙屏蔽的网站
• 文件上传、表单、编辑器、仪表盘、交互式小部件
• 任何需要保留 Cookie/会话状态的情况

阻止/失败信号（视为被阻止）

如果您尝试 markdown.new 并看到以下任何情况，请停止重试并回退到原始 URL：

• HTTP 401/403/429，“访问被拒绝”、“禁止访问”、“请求频率受限”
• 验证码 / “请确认您是人类”
• 明显与页面不符的空/部分内容
• 重定向循环或重复的导航失败

回退行为

1. 在适当的时候，尝试一次 markdown.new。
2. 如果被阻止/失败，立即切换到原始 URL 进行浏览。
3. 如果您仍然需要可提取的文本，尝试从原始页面提取（阅读器模式 / 复制文本），并清楚地注明 markdown.new 被阻止了。

注意事项 / 例外情况

• 将此用于阅读/浏览。对于 API 端点、OAuth 流程、文件上传或任何依赖 Cookie/登录状态的情况，如果代理破坏了功能，请使用原始 URL。
• 不要重写本地路径（./README.md）或非 HTTP(S) 协议。

可选的 CLI 助手

将 URL 转换为其 markdown.new 前缀形式：

node skills/markdown-url/scripts/markdown-url.js "https://example.com/docs"