Markdown hosting: turn a .md file into a shareable page

How to publish a Markdown file in three steps

1. 1Open the editor on the homepage and choose Markdown, or drop a .md file onto it: a .md file opens as Markdown automatically.
2. 2Choose Public or Private (an unlisted address), add a password if you want one, and set how many days the page stays online.
3. 3Press Publish, copy the link and keep the owner token. Your reader opens a formatted page, not raw text.

Markdown is how a lot of writing starts now: READMEs, meeting notes, specs, changelogs, and most reports that AI assistants and coding agents produce. BrewPage gives that text a web address without a static-site generator, a theme or a repository.

Publish Markdown with curl

Send the file with Content-Type: text/markdown. The response contains the link to share and the ownerToken for later updates.

Publish README.md

curl -X POST "https://brewpage.app/api/html?format=markdown" \
  -H "Content-Type: text/markdown" \
  --data-binary @README.md

Publish a weekly report for 7 days at an unlisted address

curl -X POST "https://brewpage.app/api/html?ns=team-notes&format=markdown&ttl=7" \
  -H "Content-Type: text/markdown" \
  --data-binary @weekly-report.md

Without ns the page goes to the shared public namespace. To replace the text later at the same link, send it with PUT /api/html/{ns}/{id} and the X-Owner-Token header. More examples are on the API page.

What the published page looks like

BrewPage renders standard Markdown (CommonMark) plus GitHub-style tables and automatic links, and styles the result like a GitHub README. The page follows the reader's light or dark theme and reads well on a phone.

• Headings, paragraphs, bold and italic text, block quotes, ordered and unordered lists.
• Inline code and fenced code blocks.
• Tables written with pipes and dashes.
• Links, including bare URLs that become links on their own.
• Images referenced by a full URL.

Readers get a top bar with the file name and a Download button for the original .md, so a colleague can take the source as well as read it.

Some extensions are not rendered and show as plain text: Mermaid diagrams, math formulas, footnotes, task-list checkboxes and strikethrough. Images referenced by a relative path next to the file do not appear either, because only the one file is uploaded. For diagrams, export them as images and link them by URL, or publish the document as HTML instead.

Limits

Size

One Markdown file up to 5 MB.

Lifetime

1 to 30 days, 15 by default. When the time is up the content is deleted for good, with no recovery. Updating a page keeps its original expiry date; it does not extend it.

Visibility

Public publications without a password can appear in the gallery and in search results, but neither is guaranteed. An unlisted address is not private: anyone who has the link can open it. Set a password (at least 4 characters) when readers should have to enter one.

Ownership

There are no accounts. The owner token returned with each publish is the only way to update or delete; a lost token cannot be recovered, and the content then simply expires.

Usage

Publishing and reading are rate-limited per IP address. A 429 response carries a Retry-After header that says when to try again.

Attribution

Published pages show a small BrewPage badge. Publishing follows the terms, and anyone can report a page.

Compared with other ways to share Markdown

If the document belongs in a repository for the long term, keep it there. When you need a readable link for a review, a status update or a report, publishing the file is quicker.

Markdown hosting — FAQ

Related guides