--- title: "01 Public Share Links" canonical_url: https://mdflow.cz/share/c/h0L7MvX5Cy5sST3qPnApqHOmrQ36JTVy169qJMtDMya9Kc30zm04cg9OuPSSPwvj/4691db3e-cee1-45b0-bad8-997709083105 md_url: https://mdflow.cz/share/c/h0L7MvX5Cy5sST3qPnApqHOmrQ36JTVy169qJMtDMya9Kc30zm04cg9OuPSSPwvj/4691db3e-cee1-45b0-bad8-997709083105.md visibility: public --- # Public Share Links Turn public sharing on for a document and MDflow generates a read-only link that anyone can open **without an MDflow account**. Public sharing is available on **both plans**. ## Turning it on Open the document's sharing panel and enable public sharing. You get a link you can copy with one click. Sharing is controlled **independently for each document**. There is no workspace-wide or folder-wide public switch — you publish one document at a time, deliberately. ## How the link is protected Share URLs use **random 64-character slugs**, designed to be impractical to guess. This is an *unlisted link* model, not a password: anyone who has the URL can read the document. That has a direct implication: > Treat the link as the credential. Anyone you send it to can forward it to anyone else. If that is not acceptable, use private sharing by email instead (see [02 Private Sharing by Email](/doc/2f9bcf96-ec27-400c-bd59-8d67391a8cf6)), or encrypt the document. Share pages are marked `noindex`, so search engines are asked not to list them. That is a request to well-behaved crawlers, not a security boundary. ## Turning it off Disabling sharing **permanently invalidates the link**. The old URL never works again — not now, not if you re-enable sharing later. Re-enabling generates a **fresh link**. This is the correct way to revoke access from someone who has the URL. ## What a reader can see - The document's **title and rendered body**. - Any **uploaded images the saved public document references**. - Whether **commenting** is available. What they **cannot** see: - Your identity or email address. - Any other document in your workspace. - Uploaded images that this document does not reference. - The document's version history. ## Commenting Commenting can be enabled or disabled per public document. See [04 Comments](/doc/903dfdf8-7a29-4d3c-9282-1e595e474e49). A small nicety: the commenting preference is **kept when sharing is temporarily turned off**, and restored when a new public link is generated. You do not have to remember how you had it configured. ## Letting readers clone a copy Signed-in visitors can **clone a private, independent copy** into their own workspace. - They choose a destination folder. - Referenced uploaded images are copied too, so their copy is self-contained. - The copy is **fully independent**: your later edits, deletion, or unsharing do not affect it, and their changes never touch your original. This is the mechanism for publishing a template someone should adapt rather than just read. ## Encrypted documents A shared encrypted document shows a **password gate**. Readers enter the password you share with them **separately** — MDflow never has it and cannot help them. The sharing settings warn you about this before you publish. ## Raw markdown for tools and agents Append `.md` to any share URL to fetch the document as **plain markdown**: ``` https://mdflow.cz/share/{slug}.md ``` The response begins with YAML frontmatter — title, canonical URL, markdown URL, visibility — so a tool or AI agent can cite and read it in a single request. See [05 Agent Discovery Files](/doc/e6cc65f9-1e9a-484f-b1fa-e4eb22da894d). ## Custom domain (Pro) Pro users can connect their own domain in Settings. The sharing panel then offers **both** the custom-domain URL and the permanent MDflow-domain URL. Use the MDflow-domain URL where permanence matters, since it keeps working regardless of what happens to your domain. ## When a link is dead An invalid or disabled link shows a friendly unavailable page — not an error, and not any hint about what used to be there.