Write and format documents
A Markdrop document is Markdown. You write it at markdrop.in/new, paste it from an AI assistant, or publish it from VS Code, and readers get a formatted page. This page covers what the renderer supports and how the editor helps.
What renders
#Markdrop supports GitHub-flavoured Markdown:
- Headings, bold, italic,
strikethrough, links and images. - Bulleted, numbered and task lists (
- [x] Done). - Tables, which scroll sideways on a phone instead of squashing.
- Footnotes and autolinked URLs.
- Fenced code blocks with syntax highlighting and a copy button.
Two small extras: an inline code span that holds only a colour, like `#3B82F6`, shows a swatch next to it. Image links ending in #gh-dark-mode-only or #gh-light-mode-only show only in that theme, as they do on GitHub.
Math
#Write inline math between single dollar signs and display math between double ones. Markdrop renders it with KaTeX.
The loss is $L = -\sum_i y_i \log \hat{y}_i$.
$$
\int_0^\infty e^{-x^2}\,dx = \frac{\sqrt{\pi}}{2}
$$
Diagrams
#A fenced block marked mermaid renders as a diagram instead of code:
```mermaid
flowchart LR
Draft --> Review --> Publish
```
Flowcharts, sequence, class, state and entity-relationship diagrams, Gantt and pie charts, user journeys, Git graphs, mind maps, timelines and more all work. To see several at once, open the editor and choose Try the diagrams sample.
What doesn't render
#HTML tags inside a document aren't rendered: Markdrop drops them, so a document can't run scripts or change how the page around it looks. To publish an HTML page, upload it as a file. See Publish an HTML page.
The editor
#The editor at markdrop.in/new has three views: Write, Split (text and preview side by side, scrolling together) and Preview. Markdrop remembers which one you used last.
The toolbar adds Bold, Italic, Heading, Inline code, Code block, Link and List item around your selection.
| Shortcut | What it does |
|---|---|
| ⌘ Enter / Ctrl Enter | Publish |
| ⌘ S / Ctrl S | Save, while editing a published document |
Under More actions you'll find Export PDF, Load the diagrams sample and Clear editor.
Drafts
#Until you publish, the editor keeps a draft on this device and restores it when you come back ("Restored your draft from this device"). Drafts are never kept while Encrypt is on.
Size
#A document can be up to 500,000 characters. The meter above the editor shows how many are left, and turns to a warning when fewer than 1,000 remain. With encryption on, it counts the encrypted size, which is larger than the text.
Titles
#The Title field is optional. Without one, Markdrop uses the document's first # heading, or else its first line, cut to 120 characters. The title shows in the browser tab, in My files and in link previews. Readers also see it above the document, unless the document starts with its own # heading: then only that heading shows.
Edit after publishing
#Open the document, press Esc or choose Show details to leave full screen, and choose Edit. The editor opens with the same views and toolbar, plus Settings, which opens Document settings for the password and expiry. Choose Save changes, or press ⌘ S.
Edit in Preview
#While you edit a published document, Preview is editable too: click into a heading, paragraph, list, checklist, quote, table, code block or equation and type, right where it renders. Type / on an empty line for the blocks a document can hold: text, headings, lists, a checklist, a quote, code, a table, math and a divider. Your changes carry across Write, Split and Preview.
The Markdown stays the source. Blocks you don't touch keep their exact text, so opening Preview and saving changes nothing. Raw HTML and footnotes are read-only in Preview, marked "Kept exactly as written": change them in Write (their Edit as Markdown button switches to it). If the document goes over 500,000 characters, the status line says by how much, and Save tells you instead of saving.
Readers who have the page open see the change appear, marked "Updated just now".
If you aren't signed in as the owner, you'll need the document's edit secret. See Edit with your edit secret.
What readers can do
#Readers can copy a link to any heading with its Copy link to section button, read full screen, see the raw Markdown with View raw, and save a PDF with Export PDF. Signed-in readers can choose Save a copy to put their own copy in My files.
Signed-in readers can also ask the document questions with ✦ Ask in its bar, or ⌘ J: Ask answers from the document first, with its sources. If you can edit the document, Insert under an answer opens the editor with the answer after the section you were reading; nothing is saved until you choose Save changes. End-to-end encrypted documents don't have ✦ Ask.
More about documents
#Pick an address like markdrop.in/q3-plan, and change it later.
Edit or delete a document you published without an account.
Ask for a password, or have the link stop working on a date.
What the card shows in Slack and other apps, and what it never shows.
Assemble a README from ready-made sections and publish it.
