Sharing
Visibility, link formats, custom slugs, password and expiry protection, remixing, collections, and profiles.
Visibility
Every document has one of three visibility settings.
| Setting | Who can read it |
|---|---|
| Private | Only you, and API tokens on your account. Everyone else gets a 404. |
| Unlisted | Anyone with the link. Never listed on your profile. |
| Public | Anyone with the link, and optionally listed on your public profile. |
A request for a private document you do not own returns a plain 404 rather than a "not authorized" error, so the URL does not reveal that the document exists. Changing a document away from public also removes it from your profile.
Share links
Published links live on markedb.in. The document page shows the current link under
the title, and the Share button opens a dialog with a copy field.
| Link | Shape |
|---|---|
| Short link | markedb.in/x7k2m — a five-character code assigned on publish |
| Custom link | markedb.in/yourname/my-notes — your profile slug plus a document slug |
| Direct link | markedb.in/d/<id> — always works, used when no custom slug is set |
| Raw Markdown | /d/<id>.md — the Raw link on the document page |
| TextBundle | /d/<id>.textpack — the TextBundle link, Markdown plus images |
Custom slugs
Set a Profile URL slug in Settings first — that
is the yourname part. Then give a document its own slug from the share dialog or the
finish-editing dialog.
- Lowercase letters, numbers, and hyphens
- Two to 32 characters, starting and ending with a letter or number
- Unique within your account, and not one of the reserved words the site itself uses (
api,docs,library, and similar)
Custom slugs need an account. Documents published while signed out can only use the short link.
Password and expiry
Public and unlisted documents can carry extra protection, set by the owner in the Link protection section of the share dialog.
- Password — readers see an unlock page and must enter the password before the document renders. Unlocking is remembered on that browser for 24 hours.
- Expires at — after that moment the link returns a 404. The document itself stays in your library.
Both can be removed again with the Remove password protection and Remove expiry checkboxes. The dialog shows the current state as Password on and Expires ….
A password-protected document is also hidden from the API for everyone except its owner, so a shared token cannot be used to bypass the gate.
Remixing and duplicates
Allow others to duplicate and remix adds a Duplicate to my account button for signed-in readers who are not the owner. The copy is a new private document in their library, including its images, and it opens in their editor. Your original is untouched.
The default for new documents comes from Allow remixing by default in your settings. Duplicates that other people have already made stay in their libraries even if you later turn remixing off or delete your account.
Reading styles
A reading style is the typeface, size, measure, and palette a document is read in. There are five, and each one has a light and a dark version, so a style choice and the light/dark switch in the header stay independent of each other.
| Style | Reads like |
|---|---|
| Editorial | Warm paper and a reading serif. Newsreader · 17px/1.7 |
| Manuscript | Cream stock, wide leading, indented paragraphs. Newsreader · 18.5px/1.85 |
| Swiss | Cool neutrals, tight headings, no ornament. Instrument Sans · 16.5px/1.6 |
| Contrast | Black on white, larger type, short measure. Instrument Sans · 18px/1.75 |
| Typewriter | Monospaced throughout, for drafts and specs. JetBrains Mono · 14.5px/1.8 |
As the author, pick one under Published style in the share dialog. The card shows a live miniature of the choice, and Save style applies it to everyone who reads the document without a preference of their own.
As a reader, the Aa menu in the document toolbar changes the style for the document in front of you; the button names the style you are currently reading in. The first choice in that menu follows the author, and Use this style everywhere at the bottom makes your pick the default for everything you read. Signed in, that saves to your account; signed out, it is remembered in that browser.
Nearest choice wins: what you picked for this document, then what you picked for everything, then what the author published, then Editorial. You can also set your default under Reading style in settings, where Follow each document’s published style hands the decision back to authors.
The style travels with the document. It is a reading_style field on the API,
and TextPack exports carry it in info.json, so publishing from Marked and
pulling the document back keeps the typography you chose.
Collections
A collection is an ordered group of your documents with its own page. Manage them under Collections in your library: give one a title, a slug, an optional description, a visibility, and check off the documents to include. Use Up and Down to set the order readers see.
| Collection visibility | Behavior |
|---|---|
| Public | Anyone can open it; it may include public documents only, and can appear on your profile. |
| Unlisted | Anyone with the link can open it; lists your public and unlisted documents. |
| Private | Only you can open it; lists everything you added. |
A collection page lives at markedb.in/u/yourname/c/collection-slug. Public and
unlisted collections get a Share button in the list. If you try to put a private
or unlisted document into a public collection, the save is rejected — make the document public
first, or make the collection unlisted.
Your profile
Your profile at markedb.in/u/yourname shows your display name and the things you
explicitly opted in: collections marked Show on my public profile, and public
documents with the same option checked in the finish-editing dialog. Nothing appears on your
profile automatically.