# Markdown for Agents

> Free HTML to Markdown converter built for AI agents. Paste a URL and get a clean Markdown copy of the page with navigation, headers, footers, and scripts removed. Copy it, download it, or publish it next to your HTML. No login, no ads.

This is the Markdown copy of https://usesuperflow.ai/tools/markdown-for-agents, published for AI agents and scripts.

## What it does

Turn any page into clean Markdown an AI agent can actually read, with the nav, footer, and scripts stripped out.

## How to use it

1. **Paste a page URL.** We fetch that one page the way a browser would, following redirects along the way. Nothing is crawled and nothing else is touched.
2. **We strip the chrome.** Navigation, headers, footers, sidebars, scripts, styles, and embedded frames come out. What is left is the content, converted to CommonMark with links and images resolved to absolute URLs.
3. **Copy, download, or check the preview.** Take the raw Markdown, save it as a .md file, or switch to the rendered preview to see what an agent will read before you publish it.

## Call it directly

**HTTP:** `POST https://usesuperflow.ai/api/tools/markdown-for-agents`. No API key, no account.

```bash
curl -sS https://usesuperflow.ai/api/tools/markdown-for-agents \
  -H 'Content-Type: application/json' \
  -d '{"url":"example.com"}'
```

Returns `{ ok, report: { markdown, title, description, wordCount, bytes, truncated, httpStatus }, cached, ageSeconds }`.

**MCP:** this tool is `page_to_markdown` on Superflow's MCP server at `https://usesuperflow.ai/api/mcp` (Streamable HTTP, no authentication). Setup for every client: https://usesuperflow.ai/tools/mcp

Limits: 10 runs per hour per IP. Allow up to 75 seconds for a response. Results are cached for 24 hours per URL; pass `"refresh": true` to run again.

## Facts

| | |
| --- | --- |
| Cost | Free. No login, no email, no ads. |
| Where it runs | On our servers. One guarded fetch of the page you submit, then a mechanical HTML to Markdown conversion. No AI model is involved, so the output does not vary between runs. |
| API | POST /api/tools/markdown-for-agents with a JSON body of {"url": "example.com"}. Returns {"ok": true, "report": {...}} where report carries markdown, title, description, wordCount, bytes, and truncated. Failures return {"ok": false, "code": "...", "message": "..."}, never a bare 500. |
| Rate limit | 10 runs per hour per IP. |
| Stored data | The converted document, cached for 24 hours keyed on the URL. Nothing beyond that cache. |
| Size caps | Up to 3 MB of HTML read per page, and up to 1.5 MB of Markdown emitted. A longer page is cut at a line boundary and the result is marked truncated. |
| What gets stripped | Navigation, header, footer, and aside regions, scripts, styles, noscript, template, inline SVG, and iframes. |
| What it cannot see | Content rendered in the browser by JavaScript. We read the HTML the server returns, which is also what most AI crawlers read. |

## Questions

### Why would I want a Markdown copy of my page?

Because that is closer to what a model actually consumes. An HTML page is mostly not content: navigation, cookie banners, analytics snippets, and layout markup often outweigh the words on the page. Every one of those tokens costs money and attention in an AI pipeline, and some of them actively mislead a model about what the page is for. Markdown keeps the headings, lists, tables, and links, and drops the rest.

### What exactly gets removed?

Navigation, header, footer, and sidebar regions, plus scripts, styles, noscript blocks, templates, inline SVG, and embedded frames. Everything else is converted: headings, paragraphs, lists, tables, blockquotes, code blocks, links, and images. Links and image sources are rewritten to absolute URLs so the document still works once it leaves your site.

### The output is missing content that is on the page. Why?

We read the HTML your server returns, not a rendered browser page. If your content is built in the browser by JavaScript, a raw fetch sees the empty shell around it. Server rendered and statically generated pages convert completely. Single page apps that render everything client side may convert to almost nothing, and that is a useful signal in itself, because most AI crawlers do not run JavaScript either.

### Is a site allowed to serve Markdown copies of its pages?

Yes, and a growing number do. The usual pattern is to publish the Markdown at the same path with a .md suffix and point at it from the HTML page with a link tag using rel=alternate and type=text/markdown. This site does exactly that: every tool page here has a Markdown copy at /tools/<slug>.md. There is no standard forcing anyone to honour it, but it costs nothing to serve and it is trivially easy for an agent to find.

### How big a page can it handle?

We read up to 3 MB of HTML and emit up to 1.5 MB of Markdown. Past that the document is cut at a line boundary and a note is appended saying so, rather than the whole run failing. A partial document is useful to an agent. An error is not. The page tells you when this happens.

### What if the site blocks the request?

Some sites sit behind bot protection that answers automated requests with an error, usually HTTP 403. When that happens we say so plainly instead of reporting that the page has no content. Your own site will rarely do this to you, and if it does, that is worth knowing, because the same protection is answering AI crawlers the same way.

### Do you store the pages I convert?

We cache each result for 24 hours, keyed on the URL, so repeat runs and shared links load instantly. Nothing is stored beyond that cache. No account, no email, and no history of what you converted.

## Related tools

- [AI Visibility Checker](https://usesuperflow.ai/tools/ai-visibility-checker) — See whether ChatGPT, Claude, and Perplexity can actually read your site. Markdown copy: https://usesuperflow.ai/tools/ai-visibility-checker.md
- [llms.txt Generator](https://usesuperflow.ai/tools/llms-txt-generator) — Generate a spec-correct llms.txt and llms-full.txt for any site. Markdown copy: https://usesuperflow.ai/tools/llms-txt-generator.md
- [Markdown Viewer](https://usesuperflow.ai/tools/markdown-viewer) — Open and read any Markdown file. Nothing leaves your browser. Markdown copy: https://usesuperflow.ai/tools/markdown-viewer.md
- [robots.txt AI Checker](https://usesuperflow.ai/tools/robots-txt-ai-checker) — Test your robots.txt against every AI crawler that matters. Markdown copy: https://usesuperflow.ai/tools/robots-txt-ai-checker.md

## About

Markdown for Agents is one of a set of free tools published by Superflow at https://usesuperflow.ai/tools. None of them require a login, an email address, or payment.

Category: ai-visibility.

Superflow is a website and creative-asset review tool. Its agents watch every page of a site and report what changed. See https://usesuperflow.ai.