markdown-fetch

This Skill Is For

这个 skill 用于把公开 URL 抓成适合阅读、引用、沉淀的 markdown。

适合这些场景：

• 拉官方文档或 API reference
• 读取博客、设计说明、迁移指南
• 原始 HTML 太脏，不适合直接读
• 需要把网页内容先沉淀成 repo-local research memo

一句话：

先把网页抓干净，再决定是临时阅读，还是沉淀进 .harness/research/.

这个 Skill 不依赖什么

• 不依赖 Claude 插件
• 不依赖 .claude/ 目录
• 默认只使用 Bash、curl、jq 和 markdown.new

Preferred Workflow

按这个顺序做：

1. 先确认目标 URL 是真的，不要猜地址
2. 先用 auto
3. 如果页面是 JS-heavy，再切 browser
4. 只有图片、图表、流程图确实重要时，才加 retain_images=true
5. 如果结果要进入 Klein 的共享研究面，优先写 .harness/research/<slug>.md

Preferred Command Surface

1. GET: auto

普通文档先试这个：

curl -fsSL "https://markdown.new/https://docs.python.org/3/library/pathlib.html" | sed -n '1,220p'

适合：

• 官方文档
• 普通静态页面
• 想快速预览前几百行

2. GET: browser

JS-heavy 页面或 auto 不够干净时：

curl -fsSL "https://markdown.new/https://example.com/docs?method=browser" | sed -n '1,220p'

适合：

• React / SPA 文档站
• 需要浏览器渲染后才有正文的页面

3. GET: retain_images

只有图片本身是研究对象时才打开：

curl -fsSL "https://markdown.new/https://example.com/docs?method=browser&retain_images=true" | sed -n '1,220p'

适合：

• 图表、架构图、流程图本身有价值
• 想保留图片 markdown 以便后续人工查看

4. POST: auto

URL 含查询参数、片段、shell 特殊字符，或你想拿结构化响应时，优先 POST：

curl -fsSL "https://markdown.new/" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/docs"}' \
  | jq -r '.content'

5. POST: browser / retain_images

curl -fsSL "https://markdown.new/" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/docs","method":"browser","retain_images":true}' \
  | jq -r '.content'

Method Choice

• auto
  • 默认首选
  • 适合大部分文档站
• browser
  • 页面正文依赖浏览器渲染时再用
• retain_images=true
  • 只有图片是有效信息时再开
  • 不要默认开启，避免噪音

What To Do With The Result

临时阅读

如果只是回答当前问题：

• 直接引用必要片段
• 记录 URL
• 不要为了“一次性阅读”无端写文件

研究沉淀

如果结果属于研究资料、设计依据、上游行为证据，优先沉淀到：

• .harness/research/<slug>.md

如果当前仓库没有 .harness/，且用户要可共享文档，再考虑：

• docs/<slug>.md

不要默认把网页内容塞进 .claude/ 或其他 Claude 专属目录。

推荐 memo 结构：