You've written something in Markdown — release notes, a README, meeting notes, a spec — and now you need to send it to someone. Emailing a .md file means the reader sees raw # and ** symbols instead of a formatted page. Pasting it into a chat strips the formatting entirely. The fix is to publish it as a real web page and share the link.
The quickest way: publish to a link
With md.rajkar.dev you can do this in under a minute, with no account:
- Open the Markdown editor and paste or type your Markdown. A live preview shows exactly how the page will look.
- Pick a reading theme — Default for general docs, Terminal for technical content, Essay for long-form writing, or Minimal for something quiet.
- (Optional) Set a password so only people with the password can read it, or an expiry so the link stops working after 7, 30, or 90 days.
- Click Publish. You get a clean, readable URL like
md.rajkar.dev/release-notesthat you can send anywhere.
The reader just opens the link — no account, no app, no Markdown knowledge required. They see a properly formatted page with working headings, lists, tables, and syntax-highlighted code.
Why not just use a GitHub Gist or repo?
Gists and repositories are great when your audience is other developers who already use GitHub. But they show GitHub's chrome around your content, require the reader to understand the interface, and aren't ideal for non-technical readers. A standalone published page is cleaner when you want the content — not the platform — to be the focus.
Keeping a shared page up to date
After publishing, you can come back and edit the page from the same browser — the link stays the same, so anyone you've already shared it with sees the latest version. Every edit is snapshotted, so you can compare or restore earlier versions if you need to.
When to password-protect or expire a link
- Password — for drafts, internal notes, or anything you only want specific people to read.
- Expiry— for time-sensitive content like a temporary announcement or a link you don't want lingering forever.
- Neither — for public content you want anyone with the link to read indefinitely.
That's it. If you frequently need to turn Markdown into a link, see also our guides on turning Markdown into a link and viewing a .md file online.