# FAQ

## What is this?

A place to publish markdown. Write something, hit publish, get a link.

## 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 permanent link 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?

No. Pages are permanent. If you need content removed, use the **report** link at the top of any page — select 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/a3x9k2b7
```

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

For the raw source endpoint, use the `.md` format URL: `https://markdown.page/a3x9k2b7.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.

## Limits?

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

## Who runs this?

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