Marked Share documentation
How to publish Markdown, share it, collect highlights and notes from readers, and drive all of it from Marked or the API.
What Marked Share does
Marked Share publishes Markdown documents to the web with stable, shareable links. Your Markdown source is stored as you wrote it and rendered to HTML with Apex, the same pipeline Marked uses locally, so a document looks the same online as it does in your preview window.
Two hostnames are involved, and the split matters when you are reading URLs:
| Host | Used for |
|---|---|
share.markedapp.com |
Your account: library, editor, settings, and the API |
markedb.in |
Published documents, so share links stay short |
Marked Share is free. There is no subscription and no paid tier.
Getting started
There are three ways in, and they all end up in the same library.
From the web
Sign up free, then use New document to write in the browser. You can also publish without an account: anything you create while signed out is public or unlisted, and you get a one-time edit secret instead of ownership. See Documents.
From Marked
Connect Marked to your account once, then publish the document you are previewing and update it on later shares. See Publishing from Marked.
From files or a URL
Upload Markdown files, .zip bundles, or .textpack archives from your
library, or capture a web page as Markdown with Capture URL. See
Documents.
How the pieces fit together
| Concept | What it means |
|---|---|
| Document | Markdown source plus rendered HTML, a visibility setting, and one or more share links. |
| Visibility | Private, unlisted, or public. Account documents are private by default. |
| Highlight set | One reader's highlights and notes on a document, shareable as a ?hl= link. |
| Review | Someone else's highlight set on a document you can edit, listed in the Reviews panel. |
| Collection | An ordered group of your documents with its own shareable page. |
| API token and device key | Credentials Marked (or your own scripts) use to publish and update documents. |