# FAQ

## What is this?

A place to publish Markdown and get a public URL. Write a page, publish it, get a link. No account or API key required.

## How do I publish?

Write or paste Markdown into the editor on the [home page](https://markdown.page) and click **publish** (or press Ctrl+Enter). You'll get a public URL you can share.

You can also publish via the API:

```
curl https://markdown.page/api/publish --data-binary '# Hello world'
```

Or publish a file:

```
curl https://markdown.page/api/publish --data-binary @README.md
```

Browsers/fetch clients get JSON with your slug and URL. CLI clients such as curl get the published URL as plaintext; you can also force this with `Accept: text/plain`. The API accepts raw markdown, JSON, or form fields.

## What markdown is supported?

Standard markdown plus GFM: headings, bold, italic, strikethrough, lists, task lists, links, images, inline code, fenced code blocks with syntax highlighting, blockquotes, and tables. External images work via `https://` or `http://`. Links support `https://`, `http://`, and `mailto:`.

Raw HTML, custom CSS, and JavaScript are not accepted — only pure markdown.

## Can I edit or delete a page?

Pages can't be changed after publishing — the URL always returns what you shared.

If you need to correct something, publish a new page and share that link instead. To request removal, use the **report** link at the top of any page: choose a reason, add a comment, and we'll review it.

## Can I get plaintext or raw markdown back?

Yes. CLI clients can fetch normal public pages directly and receive readable plaintext/markdown:

```
curl https://markdown.page/faq
curl https://markdown.page/JCLcR63O
```

Browsers get HTML. You can force plaintext with `Accept: text/plain`.

For the raw source endpoint, use the `.md` format URL: `https://markdown.page/JCLcR63O.md`

## Is my content private?

No. Every page is public. URLs are random and not guessable, but anyone with the link can view it. Don't publish anything sensitive.

## Can agents publish pages?

Yes. Agents can use the [`markdown-page` skill](https://markdown.page/skill.md), the broader [`llms.txt`](https://markdown.page/llms.txt) discovery guide, or the [MCP endpoint](https://markdown.page/mcp). The skill includes publishing instructions and safeguards for public, immutable content.

## Limits?

The current limit is 1 MB per page. Publishing is rate-limited per IP.

## Who runs this?

[Magic Monad](https://magicmonad.com).