← Back to Converter

Philosophy & Help

Why 2md.link?

2md.link exists because we believe URL to Markdown conversion should be free and accessible to everyone. Whether you're:

• An AI agent or bot needing to fetch web content in markdown format
• A developer building a tool that needs HTML to Markdown conversion
• A content creator who wants to quickly grab web content
• A researcher collecting data from the web

You shouldn't need to pay for a simple conversion API.

Why Free?

We keep this service free because:

• No registration required - Use it instantly without signing up
• Open to all bots/AI - We explicitly allow AI agents, scrapers, and crawlers
• No paywalls - Everyone deserves access to this basic utility
• Simple infrastructure - We use efficient, minimal infrastructure to keep costs low

Why Not Cloudflare Edge?

You might wonder why we don't use Cloudflare's Edge workers for this. Here's why:

• Bot detection - Cloudflare's Edge aggressively blocks bots, which defeats the purpose of an AI-friendly API
• JavaScript rendering - Edge workers can't render JavaScript, so dynamic sites return incomplete content
• IP blocking - Cloudflare's WAF often blocks requests from data centers

Why Do Some Sites Return 500 Errors?

Sometimes when you try to convert a URL, you might get a 500 error or incomplete content. Here's why:

• CAPTCHA Challenges - Many sites (Google, Facebook, Twitter, etc.) use anti-bot protection that shows a CAPTCHA or verification page instead of the real content
• JavaScript Rendering - Sites that heavily rely on JavaScript (SPAs, React, Vue apps) may not render properly without a browser
• Bot Detection - Some sites actively block requests from data centers or unknown IP addresses
• Rate Limiting - Popular sites may temporarily block repeated requests from the same source

Works well with: Wikipedia, blogs, documentation sites, news sites, static websites, and most sites without aggressive bot protection.

Direct fetch - Our approach fetches directly from the origin server, giving you real content

While Cloudflare is great for hosting, it's not ideal for a tool that needs to fetch from other sites freely.

Agent & AI Friendly

2md.link is built specifically for AI agents and bots:

• No JavaScript rendering required
• Simple REST API with GET and POST support
• JSON responses easy to parse
• No rate limiting for reasonable use
• No captchas or bot detection
• Explicitly allowed in robots.txt
• RSS feed for monitoring updates

API Usage

POST Request:

curl -X POST https://2md.link/api/convert \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

GET Request:

curl https://2md.link/api/convert/example.com

Direct URL:

curl https://2md.link/https://example.com

Response Format

{
  "url": "https://example.com/",
  "title": "Example Domain",
  "markdown": "# Example Domain\n\nThis domain is for use...",
  "length": 181,
  "redirected": false
}

Contact

Questions? Suggestions? Just want to say hi?

Email: support@2md.link

Made with <3 for the open web. Available to all AI agents, bots, and humans alike.