Open or paste Markdown → render it → create a link → share.
A rendered link lets someone read a .md file in a browser without downloading it, installing a Markdown viewer, or signing in. Headings, tables, code blocks, Mermaid diagrams, and LaTeX math appear as a finished document instead of raw Markdown syntax.
.md file or paste its contents.mdview.io/s/... URL and send it by email, chat, issue, or review ticket.The author needs an account to save and manage the document. Recipients do not need an mdview.io account: the link opens the rendered page directly in their browser.
The Share dialog keeps the URL, visibility, and expiry choices together. This workflow works well for project notes, specifications, meeting summaries, AI-generated reports, runbooks, release notes, and README drafts. Markdown remains the source format; the link becomes the reading experience.
For a short example, paste only the excerpt into a new document and use the same save-and-share workflow above. Give it a descriptive title so the recipient knows what the link contains. You do not need to send a complete README to discuss one checklist or code sample.
For example, this snippet can stand on its own in a review ticket:
# Release review checklist
Please check these items before Friday's release:
- [ ] Confirm the migration has a rollback plan.
- [ ] Run the smoke checks in staging.
- [ ] Record the release owner in the ticket.
Question for reviewers: which check still needs evidence?
Include enough context to answer the question: what the excerpt describes, what feedback you need, and any relevant deadline. Copy the complete opening and closing fences when the snippet contains code. Replace links to local files with addresses the recipient can actually open; an excerpt loses the surrounding repository context.
Before sharing, remove unrelated sections and internal notes from the pasted text. Open the final link without your signed-in session and check that it shows only the intended excerpt. If the recipient needs to edit the source, send the Markdown alongside the rendered link or link to the appropriate repository file.
The right sharing method depends on what the recipient needs to do with the document.
| Sharing method | Best for | Recipient experience |
|---|---|---|
Raw .md file |
Developers who need to edit, commit, or process the source | Downloads or opens Markdown source in another tool |
| Repository link | Collaborators already working in GitHub or GitLab | Reads the file within the repository and its permissions |
| Rendered share link | Reviewers, clients, teammates, and other readers | Opens a formatted document directly in the browser |
Send the raw file when the recipient needs to edit, commit, or process the source. Send a rendered link when the goal is reading, reviewing, or approving the content. For mixed workflows, keep the .md file as the source of truth and use the rendered page as the convenient reading copy.
A shareable URL is not automatically private. Before publishing, decide whether the document should be discoverable and how long the link should work.
In mdview.io, a Public share has no expiry by default and is intended for published material. Substantive public documents may be discoverable by search engines. This works well for guides, release notes, examples, and documentation you want people to find.
A Secret share is kept out of search and starts with a seven-day expiry on the free plan. Pro accounts can choose 7, 30, or 90 days, one year, or no expiry. Secret links are useful for time-boxed reviews, but they are still bearer links: anyone who receives or forwards the URL can open the document. Do not put passwords, API keys, personal data, or other sensitive material in the Markdown.
If you want a stable page that remains accessible by URL but does not appear in search results, mdview.io Pro includes Hide from Search. This reduces discovery; it does not create authenticated, recipient-only access.
A random URL is fine for a quick review. A descriptive URL is better when the link will appear in a ticket, handbook, or recurring workflow. Change the share URL to a memorable slug such as:
mdview.io/s/release-checklist
Use a slug that describes the document rather than a temporary state. api-migration-plan will age better than final-version-3. Avoid putting confidential project names or customer details in the URL itself because URLs often appear in browser history, analytics, chat previews, and server logs.
When feedback arrives, update the saved document instead of uploading another attachment. A published saved document keeps its share address while its contents change, so recipients can return to the same link for the latest version.
A practical review loop looks like this:
This avoids filenames such as proposal-final-revised-2.md and reduces the chance that someone reviews an obsolete attachment. If an exact historical snapshot matters, store versions in Git or another versioned system. A live share link is designed to present the current saved document.
Open the share link in a private browser window before distributing it. This confirms that the link works without your signed-in session and that the document is readable as published.
Review the parts most likely to break or expose unintended information:
Remember that local image paths and links such as ./diagram.png may not be available to someone opening a standalone web page. Use URLs the recipient can access, or keep essential information directly in the Markdown.
Developers may want the raw .md source, while reviewers usually want a page they can open immediately. A rendered link gives readers consistent formatting without requiring a Markdown app, repository account, or download step.
To share a Markdown file online, open it in mdview.io, render and save it, choose Public or Secret, and copy the link. Check its visibility, expiry, and recipient experience before you send it.
For a temporary review, choose a Secret share and check the expiry shown in the Share dialog before copying the URL. Free Secret shares start with seven days; Pro provides additional duration choices. A Public share has no expiry by default, so do not assume all Markdown links disappear after a week.
Send the expiry date with the link when it matters to the recipient. After the review, unpublish the share if access should end immediately. Expiry limits future access through that URL; it cannot revoke copies someone already downloaded or pasted elsewhere.
Treat a Secret link as a bearer link rather than recipient authentication. For ordinary Markdown link syntax, use the links reference; for publishing and expiry, keep this guide as the workflow reference.