How to share a Markdown file as a link anyone can read

The fastest way to share a Markdown file with someone who doesn’t use Markdown is to turn it into a web link. Emailing the raw .md makes the reader stare at pound signs and pipes; pasting it into a doc tool loses the file. Seal publishes the file as a clean, rendered web page with one share link: the reader opens it in any browser, reads a summary written for their role, and comments inline — no account, no GitHub, no software to install. The file itself stays Markdown the whole time, so your repo or your AI agent can keep working on it.

Steps

  1. Publish the Markdown file. Sign in at www.sealmd.net (email magic link), go to /new, and upload or drag the .md file — or pick one from GitHub, or have your AI agent publish it over MCP. The file becomes an immutable version rendered as a clean web page.
  2. Copy the share link. Every review has a public share link at /r/<token>. The token is a long, unguessable string: anyone who has the link can read the doc, and nobody else can find it — share pages also tell search engines not to index them.
  3. Send it to anyone. The reader opens a normal web page in any browser: rendered headings, tables, and code, plus an AI summary. No account, no GitHub, no Markdown knowledge — and they can comment inline as a guest.
  4. Publish updates to the same link. When the file changes, publish again (upload, GitHub push, or agent re-publish). The link stays the same and readers always see the latest version, with earlier versions kept.

Is the share link public?

It is capability-based: the URL contains a long random token, so only people who have the link can open it. Share pages are served with a noindex header and are excluded from the sitemap, so search engines do not list them. Approving the document still requires a verified, signed-in human — the link only grants reading and commenting.

Does the reader need an account or GitHub?

No. The share link opens a normal web page in any browser. Readers can comment as guests without signing in; a free account is only needed for identity-verified sign-off on the hosted approval workflow.

Will my Markdown render properly?

Yes — headings, lists, tables, code blocks, and links render as a clean document page, not raw text. The reader also gets an AI summary tailored to their role, so they can orient before reading the full doc.

Can I do this without a hosted service?

Yes. The free, open-source sealmd plugin renders the same kind of review page as a local HTML file in your repo — your AI agent runs it from Claude Code, Cursor, Codex, or Copilot. You share that page through your repo instead of a hosted link; the hosted share link is for readers who should not need the repo at all.

Related: Review Markdown without GitHub · Getting started with hosted Seal · How approval works · Seal vs Google Docs