How to Share a Markdown File as a Web Page

A Markdown file is plain text with marks for headings, lists and links. Opened as it is, the reader sees the marks and not the formatted page. To share it as a page, you convert it to HTML and put it online. Our Share Markdown tool does both in one step. You choose a .md or .markdown file, pick how long the page stays online, and get a link. You do not need an account.

When a link is better than the file

Send a link when the reader only needs to read: a draft to review, release notes, a README, a set of meeting notes. Send the file when the reader needs to edit it, keep it in version control, or run it through another tool. The link shows the rendered page. The file shows the source.

What the converter does to your file

The conversion runs in your browser, before anything is uploaded. It produces one HTML page with a small stylesheet and a layout that fits a phone screen. That page is what we store. We do not store the .md file.

We tested it on 25 October 2026 with a file that had a heading, bold text, a link, a table, a code block, a list, a remote image, and a script tag written as raw HTML. The heading, bold text, link, table, code block and list all appeared on the page. The heading also became the page title. The script tag was not run: it showed up as text on the page, and the page had no script element. The remote image did not load.

What does not carry over

• HTML inside the Markdown. It is shown as text and never interpreted. A link that would run a script is not turned into a link.
• Images from other web addresses. The viewer blocks requests to other sites, so a picture linked from somewhere else will not show. Pictures have to be inside the page, and this converter does not embed them for you.
• Anything we did not test. We did not try footnotes, task lists, math or diagrams. If your file depends on them, upload it and look at the result before you send the link.

How to share the file, step by step

1. Open the Share Markdown page and choose your file, or drop it on the box.
2. Check the link name. It is your file name without .md and can contain only letters, numbers and hyphens.
3. Pick how long the page should stay online: 1 hour, 24 hours or 7 days.
4. Tick the box that says you have the right to share the file and that it follows the acceptable use rules.
5. Press Upload and get link.

You get a view link to send and a delete link to keep. The page tells you to save the delete link now, because we cannot show it again and cannot recover it.

Limits and when not to use this

• Anyone with the link can read the page. There is no password and no sign-in.
• Pages last at most 7 days. Then they are deleted.
• One file, up to 1 MB.
• We do not review pages before they go online. Do not upload anything private or confidential, and nothing you have no right to share.
• You cannot edit a page in place. To change it, delete the page, fix the file and upload it again. You get a new link.

If you want notes to stay online for months, or to be visible only to certain people, use a tool that offers that. This one is for sharing something this week.

Where the page is stored and who can find it

We upload the converted page to our servers over HTTPS and store it so the link works. We delete it when it expires or when someone uses the delete link. Uploaded pages are marked so that search engines are asked not to list them. Read the privacy policy for the details and the acceptable use rules for what you may not share.

Related guides

If your page is already HTML, read how to share an HTML file as a link. For a report or a proposal that you want a client to read, see how to share an HTML report or proposal with a client.

Frequently asked questions