This is an example of what a post can look like when shared on social media. Thanks to the new Open Graph generator, links get a nice “card” preview with the headline of the post in the image, and a summary in the description.
Marked Share is meant for, well, sharing. So making your documents look as inviting as possible is an important part of that. Hopefully these new features will make both of us look good!
A short tour of what just landed on Marked Share — with live examples in this post so you can see the plumbing instead of only reading about it.
Share renders with Apex. 1.0.20 fixes two bugs that showed up on real documents:
A -->|Yes| B no longer get a fake table separator injected into the diagram source.Older shares that were stored with broken HTML can heal on open via on-read refresh.
MultiMarkdown / Kramdown-style definition lists work as styled <dl> blocks again:
mermaid blocks, drawn in the browser.$…$ / $$…$$), typeset when MathJax is enabled on the page.Labeled edges used to corrupt the fence. This graph should render cleanly:
graph TD
Publish[Publish Markdown] --> Apex[Apex HTML]
Apex -->|Yes| Mermaid[Client Mermaid]
Apex -->|No| Plain[Plain pre block]
Mermaid --> Share[Share page]
Inline SVG is allowed through sanitization (with dangerous bits scrubbed). A simple mark:
Apex emits math hooks for inline and display TeX. With MathJax on the document page, these typeset; without it you still see the TeX source rather than nothing.
Inline: the identity \(e^{i\pi} + 1 = 0\) still hits.
Display:
\[ \int_{-\infty}^{\infty} e^{-x^{2}}\,dx = \sqrt{\pi} \]
Fenced math blocks are supported the same way Mermaid is (source in a math fence until the client runtime picks them up):
\sum_{n=1}^{\infty} \frac{1}{n^{2}} = \frac{\pi^{2}}{6}
GitHub-style callouts are enabled in the renderer:
Front matter (YAML / MMD / Pandoc) is stripped from the HTML view only. Raw download and TextBundle still include your source.
A paragraph that starts with
Note:under an H1 is not MultiMarkdown metadata anymore — it stays on the page.
Two related fixes:
Title, Author, …) as metadata. Prose like Note: … or First span: … under a heading stays visible. Existing shares that lost an H1 + colon paragraph can refresh on read.Click a text highlight → share icon on the floating bar → live PNG preview with Download and Copy image.
The card is square (1080×1080): document title, gradient quote (coral → purple), attribution. Handy for pasting into Slack, Notes, or social without screenshot gymnastics. Open Graph images for ?hl= links are still a follow-up.
If something still looks wrong on an old link, open it once (refresh heals many cases) or republish. Bugs with a Raw vs rendered diff are especially helpful on support.
Marked Share is built API-first. The same HTTP endpoints powering the Marked desktop app and the web frontend are available for your own scripts, Raycast extensions, Alfred workflows, and automated publishing pipelines.
The API is located at https://share.markedapp.com/api/v1.
Requests require an API Token and write operations require an X-Device-Key header:
Authorization: Bearer <your_api_token>
X-Device-Key: <your_device_key>
Tokens and device keys can be created in your account settings.
GET /documents?q=query&limit=25 supports full-text ranked search and pagination headers (X-Total-Count, Link).POST /documents accepts either raw JSON with body_markdown, title, visibility, and collection_slug, or multipart TextPack archives (.textpack / .zip).PATCH /documents/:id updates content safely with If-Match: <content_hash> optimistic concurrency locking.GET /documents/:id/textpack downloads the complete document bundle with images and metadata.GET /documents/:id/highlight_sets lists all reader highlight sets on your documents.POST /documents/:id/highlight_sets/:set_id/import merges a reviewer’s feedback into your personal highlight set.GET /collections returns all collections, their display modes, and custom domains.GET /collections/:id?include=documents lists collection metadata and member posts.POST /documents/:id/microblog triggers immediate Micropub syndication with format: "full" or format: "excerpt".Because Marked Share accepts standard Markdown over a clean REST API, you can easily integrate it into your existing tools:
curl -X POST https://share.markedapp.com/api/v1/documents \
-H "Authorization: Bearer $MARKED_API_TOKEN" \
-H "X-Device-Key: $MARKED_DEVICE_KEY" \
-H "Content-Type: application/json" \
-d '{
"document": {
"title": "My Post",
"body_markdown": "# Hello World\nPublished via curl.",
"visibility": "public",
"collection_slug": "marked-share"
}
}'
With simple API primitives, you can publish from anywhere, script backups, and build custom workflows tailored to your writing habits.
For many writers, publishing on the web means participating in the open web and IndieWeb ecosystems. Marked Share includes native integration with Micro.blog, letting you cross-post documents directly from your library.
Connecting Micro.blog takes just a few seconds:
@username.Once connected, publishing to Micro.blog is available directly from the document toolbar and share dialog:
Once published, your document displays a direct badge link to the Micro.blog post. If you are running a public Marked Share collection as a blog, changes also ping relevant endpoints to ensure feed readers and subscribers receive updates immediately.
Cross-posting long-form drafts or short notes to your personal Micro.blog timeline has never been easier.
Marked Share was built to be the ideal cloud companion to Marked for macOS. Instead of having to copy and paste text or manage file uploads through a web browser, Marked can communicate directly with your Marked Share account.
Connecting Marked to your Marked Share account requires no manual API key generation or copy-pasting:
share.markedapp.com/auth/marked).x-marked-3://login?api_token=...&device_key=....Once connected, sharing a document from Marked is seamless:
markedb.in/...) immediately, ready to copy to your clipboard or open in your browser.When you edit a document in your local editor and preview it in Marked, sharing it again updates the existing remote document rather than creating duplicates.
To prevent accidental data loss:
content_hash.If-Match header with the last known hash.409 Conflict, naming the specific device that made the newer change.When readers leave highlights and comments on your shared document, you can pull those reviews back into Marked. Marked imports the reader’s highlights.json and displays their feedback directly over your local preview.
Portable file formats are essential for avoiding vendor lock-in. Marked Share embraces the open TextBundle and TextPack standards to keep your content self-contained and universally readable.
A TextBundle is an open format that groups Markdown text and all associated assets into a single bundle folder. A TextPack is simply a compressed (zipped) TextBundle file with a .textpack extension.
Inside a Marked Share TextPack archive, you will find:
text.md (or text.markdown): The complete, raw Markdown source.assets/: Embedded images referenced throughout the text (PNGs, JPEGs, GIFs, WebPs).info.json: Metadata specifying the Markdown dialect and published reading style preferences.highlights.json: Any highlights, notes, and signatures attached to the document.You can import documents into your Marked Share library at any time:
.textpack, .zip, or .md file directly into your Library or upload area.Every document published on Marked Share can be exported immediately:
/d/<id>.md./d/<id>.textpack.Because Marked Share exports follow the standard TextBundle specification, you can open exported TextPacks in Marked, Ulysses, Bear, or any compatible editor with all images and reading styles completely intact.
Most publishing tools treat readers as passive consumers. Marked Share turns every shared document into a collaborative review surface with built-in highlighting and margin notes.
Anyone with permission to view a document can annotate it—no account or login required.
There are two easy ways to highlight:
h to toggle a highlight on the currently active block, or press c to attach a comment.If you are doing a deep proofread, turn on Highlight as I select in the Highlights menu. Every selection you drag across will instantly become an active highlight without extra clicks.
When you attach comments to highlights:
Your annotations never overwrite anyone else’s. Every reader creates their own distinct Highlight Set.
When you share your annotations, Marked Share generates an annotated link with a ?hl=<id> query parameter. Anyone following that link sees the document with your specific highlights and comments overlaid.
If you are the author of a document, you have access to the Reviews panel.
Here you can:
Reading Markdown on the web should feel as deliberate and polished as reading a well-typeset book. Marked Share brings the previewing sensibilities of Marked right into the browser.
When viewing a document, Marked Share includes keyboard navigation and reading position tracking:
Press ? on any document page to view the navigation shortcuts:
j / k or ↓ / ↑: Move to the next or previous block.gg / t: Jump to the top of the document.G / b: Jump to the bottom of the document.Page Down / Page Up (or Ctrl-d / Ctrl-u): Page down or up while maintaining reading focus.e: Instantly jump into the editor (if you have permission).Typography can make or break long-form prose. Marked Share includes five distinct reading styles, each available in independent Light and Dark modes:
As an author, you can set a Published Style in the Share dialog to give your document an intended aesthetic.
However, readers always remain in control:
Aa menu).This balance ensures authors can suggest a tone while readers can always choose the typography that works best for their eyes.
While Marked Share plays nicely with external Markdown editors via Marked and our API, it also features a built-in web editor designed for focused writing and fast edits.
The editor is powered by CodeMirror, offering syntax highlighting and a distraction-free environment with standard keyboard shortcuts:
⌘B / Ctrl-B: Bold
⌘I / Ctrl-I: Italic
⌘E / Ctrl-E: Inline code
⌘K / Ctrl-K: Insert linkTab / Shift-Tab: Indent / Outdent list items and code blocksAs you type, changes are autosaved in real time with continuous feedback in the status bar.
You don’t need external image hosting to write rich documents. In the editor, click the Image icon to:
When you upload an image, Marked Share stores it securely with your document and inserts a scoped path (/d/:id/i/...) that automatically inherits the document’s visibility permissions.
Every time you save substantial changes, Marked Share records a snapshot in the document’s Version History. You can view past versions, see which device made each edit, and inspect visual diffs to track changes over time.
Marked Share also protects you against accidental overwrites. If you leave a tab open and edit the same document on your Mac in Marked or from another browser, the editor detects the newer revision and warns you: Updated elsewhere — refresh to continue. Your changes won’t silently clobber someone else’s work.
If enabled in your document settings, signed-in readers can click Duplicate to my account. This creates an independent clone in their own library—complete with all attached images—allowing them to remix, iterate, and build upon your shared drafts.
Publishing a document in Marked Share is designed to give you precise control over who can read your work and how it is organized.
Every document in your library has one of three visibility settings:
404 Not Found—not an authorization challenge—so the link never leaks that the document even exists.When you publish, Marked Share generates clean short links on markedb.in:
markedb.in/x7k2m — quick 5-character slugs generated on publish.markedb.in/yourname/custom-slug — human-readable URLs tied to your profile handle.markedb.in/d/<id>.md — instant access to clean plain text.markedb.in/d/<id>.textpack — zipped bundle containing the markdown and all embedded assets.Need extra security? You can add password protection or an expiration date directly from the Share dialog. Password-protected documents require readers to enter a passphrase before unlocking, and expired documents gracefully return 404s after their deadline.
A Collection is an ordered group of documents with its own landing page at markedb.in/u/yourname/c/collection-slug.
Collections can be displayed in two modes:
/feed.xml.You can even attach custom CNAME domains to collections, turning Marked Share into a lightning-fast Markdown blogging engine.
For years, Marked has been my playground for turning Markdown into beautifully rendered documents on macOS. But while previewing Markdown on your local machine is great, sharing those documents with clients, editors, or friends has always felt a little fragmented. You export to PDF, print to HTML, or paste text into a generic pastebin that ruins your formatting.
I built Marked Share to solve that problem.
Marked Share is a Markdown-native publishing and sharing platform designed from the ground up to pair with Marked (and with any plain-text workflow). It gives your Markdown documents stable, shareable links, gorgeous typography, and collaborative annotation tools without the weight or complexity of a traditional CMS.
The core philosophy of Marked Share is simple:
share.markedapp.com, while published documents get clean, minimal share links on markedb.in.Whether you want to publish a quick public note, send a password-protected draft to a client, or publish a full blog with an Atom feed, Marked Share handles it with zero friction.
Over the next few posts, I’ll walk through everything Marked Share can do—from collections and typography styles to interactive annotations, TextPack bundles, and our API.