Documents
Creating documents in the browser, editing them, importing files, and capturing web pages.
Create a document on the web
New document in the header (or /documents/new) opens the publish
form. It has three fields: Title, Markdown, and
Visibility. Press Publish and you land on the document with
the share dialog already open.
Signed in, you can choose private, unlisted, or public, and a document with no visibility set is private. New documents inherit the Allow remixing by default preference from your settings.
The Markdown body is required and can be up to 500 KB. Image uploading is not available on the create form: publish first, then open the document for editing.
Publishing without an account
You can publish while signed out. Those documents have no owner, so the visibility choices are public and unlisted only, and the document page shows an edit secret once:
Save your edit secret. It is displayed a single time. The same browser keeps a cookie so you can keep editing there, but the secret is what lets you edit or claim the document later. Custom share links require an account.
Edit a document
Open Edit from the document toolbar or from your library. The editor is CodeMirror with a Markdown toolbar: heading level, bold, italic, code, link, image, blockquote, bulleted list, and numbered list.
| Shortcut | Action |
|---|---|
| ⌘B / Ctrl-B | Bold |
| ⌘I / Ctrl-I | Italic |
| ⌘E / Ctrl-E | Inline code |
| ⌘K / Ctrl-K | Insert link dialog |
| Tab | Indent |
Changes autosave while you type; the status bar shows Saving… and then All changes saved. The status bar also holds a visibility menu that applies immediately, so you can flip a draft to unlisted without leaving the editor.
Finish edit opens a dialog with the share link, a Copy button, and the per-document options: a custom URL slug, Allow others to duplicate and remix, and Show on my public profile (available for public documents only). It also links to the document's history.
If the same document is edited from somewhere else — another tab, another Mac, or Marked — you will see Updated elsewhere — refresh to continue. Refresh to pick up the newer version. Marked Share never silently overwrites a newer copy.
Images
In the editor, the image button opens Insert image, which takes an image URL
and alt text or lets you Upload file. Uploading inserts the hosted Markdown for
you and stores the file with the document, served from a /d/:id/i/… URL that
respects the document's visibility.
- Formats: PNG, JPEG, GIF, and WebP
- Up to 5 MB per image
- Up to 25 MB of images per document
Version history
A snapshot is recorded every time the Markdown body changes. History lists them newest first with the device that made the change, and View changes shows a diff against the previous snapshot. History is view-only in this release; restoring an old version is not available yet.
Your library
Library lists everything you own with its visibility and last update, plus Edit and Delete for each row. Search covers both titles and document contents. Select rows with the checkboxes to delete several at once.
The sort menu beside the search box orders the list by Last updated (the default), Date created, or Title. Sorting by date created switches each row to show its creation date instead of its last update. While a search is active, Last updated keeps the best matches on top; picking created or title sorts the matches by that field instead.
The library is keyboard-driven. Press ? to see the shortcuts:
| Key | Action |
|---|---|
| / | Focus search |
| ↑ ↓, j k | Move through results |
| Enter, o | Open the document |
| e | Open the editor |
| Esc | Clear search or close the shortcut list |
Import files
Upload in the library accepts a single Markdown file or a bundle:
| Format | Notes |
|---|---|
.md .markdown .mdown .mkd .mkdn |
Plain UTF-8 Markdown. The title comes from the filename. |
.textpack |
A zipped TextBundle: text.md plus an assets folder. |
.zip |
Any archive with a Markdown file in it, images optional. |
Images inside a bundle are stored as document assets and the Markdown image paths are rewritten to hosted URLs, so an imported document has no broken links and no dependency on the archive. For bundles the title comes from the first level-one heading when there is one. Imported documents start out private and open in the editor.
Browsers cannot upload a .textbundle folder, so export or zip it as
.textpack first. Marked sends TextPacks directly through the API.
Capture a URL
Capture URL turns a web page into a Markdown document. Paste a page URL and press Capture; you get a new private document with the extracted Markdown, and remote images are re-hosted alongside it.
The original URL is saved as permanent attribution and shown as Captured from under the title of the document. It cannot be edited later.