markdown-fetch

Convert web pages to clean Markdown using the markdown.new conversion service.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/surfingalien/FinSurfing --skill markdown-fetch-surfingalien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-fetch
Source: https://github.com/surfingalien/FinSurfing/tree/main/.claude/skills/markdown-fetch
Command: npx skills add https://github.com/surfingalien/FinSurfing --skill markdown-fetch-surfingalien

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, and includes scripts (resource) components.

What problem does it solve? Fetching web content as raw HTML wastes context window tokens and produces noisy output full of markup, making it hard to read, summarize, or analyze web pages efficiently. ## Core Features & Use Cases - URL-to-Markdown Conversion: Fetches any URL and returns clean Markdown with metadata (title, method, duration) via the markdown.new service, reducing token usage by roughly 80% compared to raw HTML. - Three Conversion Methods: Choose auto (Markdown-first with fallback), ai (Cloudflare Workers AI), or browser (full rendering for JavaScript-heavy sites like React or Vue apps). - Flexible Output: Print to stdout, save to a file with --output, or retain image references with --retain-images. - Use Case: When a user shares a link to a blog post or documentation page and asks for a summary, fetch the page as Markdown first, then summarize the clean content without HTML noise. ## Quick Start Fetch the content of the URL the user provided and convert it to Markdown, using browser rendering if the site is JavaScript-heavy.

Frequently Asked Questions about markdown-fetch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a web page to Markdown from the command line?

Run the fetch.sh script with a URL to convert a web page to Markdown via the markdown.new service. Use --output to save to a file, or pipe stdout directly into other tools for further processing.

How do I fetch content from JavaScript-heavy websites?

Use the --method browser option, which renders the page in a full browser before conversion. This handles React, Vue, and Angular sites where the default auto method only retrieves the HTML skeleton without executing JavaScript.

What dependencies are required to convert URLs to Markdown?

The script requires jq for JSON processing and curl for HTTP requests, both standard command-line tools. Install jq with brew install jq on macOS; no other libraries or npm packages are needed.

Why does web page fetching return empty or missing content?

Empty output usually means the site renders content with client-side JavaScript, so switch to --method browser. Other causes include rate limiting (HTTP 429), paywalls, or charset encoding mismatches on the source page.

Can this fetch paywalled or login-protected articles?

No, the service cannot bypass authentication or paywalls by design. For protected content, try public preview links, RSS feeds, or archive services, or ask the user to provide authenticated access separately.