markdown.new — 网页转Markdown
v1.0.0将任意公开网页一键转换为干净 Markdown，专为 AI 工作流设计，支持摘要、RAG 向量库构建等场景，URL 粘贴即用，无需安装。
40· 1.8万·32 当前·36 累计
by @joelchance下载技能包
最后更新
2026/4/21
安全扫描
OpenClaw
安全
high confidence该技能按说明工作：它通过调用 markdown.new 将公开 URL 转换为 Markdown，并包含一个小型的自包含 Python 脚本；所请求或安装的内容与该目的相称。
评估建议
此技能内部连贯且简单：它将目标 URL 发布到 markdown.new 服务并返回 Markdown。在安装或使用之前，1) 避免传递私有、内部或付费墙 URL（这些 URL 将被发送到外部服务并可能泄露信息）；2) 小心写入输出的位置（如果使用 --output 或 --deliver-md，脚本将创建目录和文件）；3) 脚本接受 --api-url 覆盖 — 仅使用受信任的端点（更改可能会将 URL 发送到不同的、可能是恶意的服务）；以及 4) 首先在安全环境中测试技能（使用公开、非敏感的 URL）以确认行为。如果需要转换内部内容，请考虑先运行自托管转换工具或验证 markdown.new 服务的隐私/条款。...详细分析 ▾
✓ 用途与能力
名称/描述（通过 markdown.new 进行 URL→Markdown）与包含的脚本和文档一致。未请求不相关的凭证、二进制文件或安装步骤；有效负载（POST 到 https://markdown.new/）正是此技能所需要的。
ℹ 指令范围
SKILL.md 专注于任务（验证公开的 http/https URL，调用 markdown.new，处理速率限制，写入输出）。它明确警告仅转换公开页面。注意：说明强调从技能目录运行脚本并捕获响应标头/元数据；使用 --output/--deliver-md 时脚本可以写入文件，因此用户应注意输出路径。
✓ 安装机制
无安装规范（仅指令加一个小脚本）。安装时技能不会下载或提取任何内容，从而降低了风险。
ℹ 凭证需求
技能不请求环境变量或密钥。但是，它会将目标 URL 发送到外部服务（markdown.new）。这对于所述目的是预期的，但如果误用可能会泄露内部主机名或私有 URL；SKILL.md 关于仅转换公开页面的指导是适当的，应该遵循。
✓ 持久化与权限
没有 'always: true' 或其他提升的持久化；用户可调用和代理自主是默认的，也是适当的。该技能不会修改其他技能或系统级配置。
安全有层次，运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv1.0.02026/2/20
NULL
● 可疑
安装命令
点击复制官方npx clawhub@latest install markdown-convert
镜像加速npx clawhub@latest install markdown-convert --registry https://cn.longxiaskill.com 镜像可用
本土化适配说明
markdown.new — 网页转Markdown 安装说明： 安装命令：npx clawhub@latest install markdown-convert 支持国内镜像加速，使用 --registry https://cn.longxiaskill.com 参数可加速下载
技能文档
使用此技能通过 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'
工作流程
- 验证输入 URL 是公开的
http或https。 - 首先使用
--method auto运行scripts/markdown_new_fetch.py。 - 如果输出缺少 JS 渲染内容，请使用
--method browser重新运行。 - 仅在需要图像链接时才启用
--retain-images。 - 捕获响应元数据（
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 渲染页面更可靠，但可能会遇到速率限制。
错误处理
- 脚本以非零代码可能表示：
- 脚本输出会在成功时写入 stdout 上的 Markdown（如果不使用 --output），并在失败时写入 stderr 上的信息。
使用 --deliver-md 会自动保存到当前目录，并将文件名基于 URL 创建一个 .md 文件。
如果遇到 429：
- x-rate-limit-remaining（以及其他标头）在需要时可用。
- 重试策略：
参考
- markdown.new：https://markdown.new/
- 源代码（如有）：https://github.com/---