Markdown.new

使用此技能，通过markdown.new将公共URL转换为可供LLM使用的Markdown。

路径解析（关键）

• 解析像scripts/...和references/...这样的相对路径时，应从技能目录解析，而非工作区根目录。
• 如果当前目录未知，请使用绝对脚本路径。

python3 ~/.codex/skills/markdown-new/scripts/markdown_new_fetch.py 'https://example.com'

cd ~/.codex/skills/markdown-new
python3 scripts/markdown_new_fetch.py 'https://example.com'

避免在任意工作区根目录下使用此模式：

python3 scripts/markdown_new_fetch.py 'https://example.com'

工作流程

1. 验证输入URL是公开的http或https。
2. 运行scripts/markdown_new_fetch.py首先使用--method auto。
3. 如果输出缺少JavaScript渲染的内容，请使用--method browser重新运行。
4. 仅在需要图片链接时启用--retain-images。
5. 捕获响应元数据（包括x-markdown-tokens、x-rate-limit-remaining以及存在的JSON元数据）以供下游规划使用。

快速开始

以下命令假设当前目录为技能根目录（~/.codex/skills/markdown-new）。

python3 scripts/markdown_new_fetch.py 'https://example.com' > page.md

python3 scripts/markdown_new_fetch.py 'https://example.com' --method browser --retain-images --output page.md

python3 scripts/markdown_new_fetch.py 'https://example.com' --deliver-md

方法选择

• auto：默认。让 markdown.new 使用其最快成功的处理流程。
• ai：强制使用 Workers AI 进行 HTML 转 Markdown 转换。
• browser：强制使用无头浏览器渲染 JavaScript 密集的页面。

首先使用auto，仅在需要时重试使用browser。

交付模式

• 使用--deliver-md以强制文件输出为.md格式。
• 在交付模式下，内容被包装为：
  • <url>
  • ...markdown...
  • </url>
• 如果--output被省略，脚本会根据URL自动生成一个文件名。

API 模式

• 前缀模式：
  • https://markdown.new/https://example.com?method=browser&retain_images=true
• POST 模式：
  • POST https://markdown.new/
  • JSON 请求体：{"url":"https://example.com","method":"auto","retain_images":false}

对于自动化和需要明确参数的情况，建议使用 POST 模式。

限制与安全

• 将429状态码视为速率限制（文档限制：500 次请求/天/IP）。
• 仅转换可公开访问的页面。
• 遵守robots.txt、服务条款和版权限制。
• 不要将 markdown.new 的输出视为对每个页面都保证完整；请验证关键提取内容。

参考

• references/markdown-new-api.md