Back to Details

markdown-url

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

markdown.new URL Prefix

markdown.new URL前缀

Whenever you need to visit a website URL, you must:
  1. rewrite it to go through 
    https://markdown.new/
    , then
  2. visit the rewritten URL, and
  3. pull the Markdown content from that page for use in your answer/notes.
当你需要访问某个网站URL时，必须：
  1. 将其重写为通过
    https://markdown.new/
    访问的形式，
  2. 访问重写后的URL，
  3. 从该页面提取Markdown内容，用于你的回复/笔记中。

Rewrite Rule

重写规则

  1. Normalize the destination into an absolute URL with a scheme (
    https://
    preferred).
  2. Prefix it with 
    https://markdown.new/
    (do not drop the original scheme).
  1. 将目标地址标准化为带协议的绝对URL（优先使用
    https://
    ）。
  2. 在其前添加
    https://markdown.new/
    前缀（不要去掉原协议）。

Examples

示例

  • 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
  • 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

Agent Workflow (Required)

Agent工作流（必填）

When you would normally open a website to read it:
  1. Produce the rewritten 
    markdown.new
    URL.
  2. Visit the rewritten URL first (not the original), but only when it is likely to work (see Policy below).
  3. Extract the page content from the Markdown view (the rendered Markdown and/or the raw Markdown).
  4. Use that extracted Markdown as the source for summaries, quotes, checklists, or copy/pasteable notes.
If the 
markdown.new
view fails to load or breaks critical functionality, fall back to the original URL for browsing, but still prefer 
markdown.new
for any content extraction if possible.
当你通常需要打开网站阅读内容时：
  1. 生成重写后的
    markdown.new
    URL。
  2. 优先访问重写后的URL（而非原URL），但仅在它可能正常工作时使用（见下方政策）。
  3. 从Markdown视图中提取页面内容（渲染后的Markdown和/或原始Markdown）。
  4. 将提取的Markdown用作总结、引用、清单或可复制笔记的来源。
如果
markdown.new
视图加载失败或关键功能无法使用，则回退到原URL进行浏览，但如果可能的话，仍优先使用
markdown.new
提取内容。

Policy: When To Use markdown.new (Required)

使用政策：何时使用markdown.new（必填）

Do NOT route every site through 
markdown.new
. Use it primarily for "read-only" pages where you want clean, extractable text:
  • Documentation pages
  • Blog posts / announcements / changelogs
  • GitHub issues/PR discussions (when you just need readable text)
  • Articles and guides
Skip 
markdown.new
and go straight to the original URL when the destination is likely to be blocked or requires the original site behavior:
  • Login, OAuth, checkout, payment, or any authenticated workflow
  • Sites that gate content behind JS apps, CAPTCHAs, bot detection, or paywalls
  • File uploads, forms, editors, dashboards, interactive widgets
  • Anything where cookies/session state must be preserved
不要将所有网站都通过
markdown.new
路由。主要将其用于你需要简洁、可提取文本的“只读”页面：
  • 文档页面
  • 博客文章/公告/更新日志
  • GitHub问题/PR讨论（当你只需要可读文本时）
  • 文章和指南
当目标网站可能被拦截或需要保留原网站行为时，跳过
markdown.new
直接访问原URL：
  • 登录、OAuth、结账、支付或任何需要认证的流程
  • 通过JS应用、验证码、机器人检测或付费墙限制内容的网站
  • 文件上传、表单、编辑器、仪表盘、交互式组件
  • 任何需要保留Cookie/会话状态的场景

Block/Failure Signals (Treat As Blocked)

拦截/失败信号（视为被拦截）

If you try 
markdown.new
and see any of the below, stop retrying and fall back to the original URL:
  • HTTP 
    401/403/429
    , "Access denied", "Forbidden", "rate limited"
  • CAPTCHA / "verify you are human"
  • Empty/partial content that clearly does not match the page
  • Redirect loops or repeated navigation failures
如果你尝试使用
markdown.new
时遇到以下情况，停止重试并回退到原URL：
  • HTTP 
    401/403/429
    状态码、“访问被拒绝”、“禁止访问”、“速率限制”
  • 验证码/“验证你是人类”
  • 内容为空或不完整，明显与原页面不符
  • 重定向循环或多次导航失败

Fallback Behavior

回退行为

  1. Attempt 
    markdown.new
    once when appropriate.
  2. On block/failure, immediately switch to the original URL for browsing.
  3. If you still need extractable text, try to extract from the original page (reader mode / copy text) and clearly note that 
    markdown.new
    was blocked.
  1. 在合适的情况下尝试一次
    markdown.new
    。
  2. 若被拦截/失败，立即切换到原URL进行浏览。
  3. 如果你仍需要可提取的文本，尝试从原页面提取（阅读器模式/复制文本），并明确注明
    markdown.new
    被拦截。

Notes / Exceptions

注意事项/例外情况

  • Keep this for reading/browsing. For API endpoints, OAuth flows, file uploads, or anything that depends on cookies/login state, use the original URL if the proxy breaks functionality.
  • Do not rewrite local paths (
    ./README.md
    ) or non-HTTP(S) schemes.
  • 此工具仅用于阅读/浏览。对于API端点、OAuth流程、文件上传或任何依赖Cookie/登录状态的操作，如果代理导致功能异常，请使用原URL。
  • 不要重写本地路径（如
    ./README.md
    ）或非HTTP(S)协议的地址。

Optional CLI Helper

可选CLI助手

Convert a URL into its markdown.new-prefixed form:
bash
node skills/markdown-url/scripts/markdown-url.js "https://example.com/docs"
将URL转换为带markdown.new前缀的形式：
bash
node skills/markdown-url/scripts/markdown-url.js "https://example.com/docs"