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
- 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.
- 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.
- 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.
- 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