Publishing and sharing Markdown on the web has always felt a little disjointed. Sometimes you just want to send a formatted document to a client or colleague and let them leave highlights and notes without setting up accounts, shuffling files back and forth, or setting up a GitHub repo.

I built Marked Share to solve this. It’s a free online publishing service designed to give your Markdown a beautiful, permanent home on the web. And while it integrates seamlessly into Marked 3, it also works completely standalone in any browser.

Standalone Publishing for Everyone

You do not even need Marked installed to use Marked Share. You can sign up for a free account at share.markedapp.com, or even post without an account if you just need a disposable share.

Here is what you can do right out of the box:

  • Rich Document Uploads: Drop raw .md files, zipped directories with images, or full .textpack bundles right into your library.
  • URL Capture: Hand Marked Share any URL and it will fetch and convert the web page into clean Markdown for you.
  • Built-in Markdown editor: A customized CodeMirror instance with rich Markdown editing features. While you can upload any document, you can also write and publish using just the web service if you want to.
  • Fuzzy document search: nvUltra-style full text search of your documents, with full keyboard navigation.
  • Highlighting and Reader Reviews: Readers can highlight passages, attach notes, and send you feedback. When someone highlights a draft, it creates a unique review set that links right back to the specific phrases.
  • Short Links: Every published document gets a clean, short URL via markedb.in for easy sharing on social media or in chat.
  • Collections & Blog Mode: Group your documents into curated collections. You can even toggle any collection into a blog format, complete with reverse-chronological ordering, custom slugs, and an ATOM feed. You can check out the Marked Share development log to see how collections look in action. (You can even assign a wildcard *.markedb.in url to a blog.)
  • Micro.blog Integration: Connect your Micro.blog account in settings to publish full posts or summary excerpts with backlinks in a single click. Publish entire feeds from collections or individually select documents to post.

Reading Styles You (and Your Readers) Control

When you write in Markdown, presentation matters. Marked Share ships with custom reading styles—like Editorial, Manuscript, Swiss, Contrast, and Typewriter.

As the publisher, you can set a default reading style that matches the vibe of your document. But readers are never trapped in your aesthetic choices: anyone viewing your document can switch styles, toggle dark mode, or adjust font sizes to match their own reading preferences.

Deep Integration in Marked 3

If you use Marked 3 on macOS, sharing is built right into your workflow.

Connecting your Mac to your account takes just a few seconds. Choose File > Publish > Connect Account…, approve the login in your browser, and Marked automatically receives your credentials and stores them securely in the macOS Keychain.

From there, publishing is instant:

  • One-Click Publishing: Hit File > Publish > Publish… to push your active document to the web.
  • Reading Mode Highlights: If you have annotated your document in Marked’s Reading Mode, you can include those highlights and comments directly in the uploaded TextPack.
  • Visibility Control: Set documents to Private, Unlisted, or Public. Documents added to public collections are automatically configured for public viewing.
  • Publish to Collection: Use the File > Publish > Publish to Collection submenu to send a document straight to a specific collection or blog stream.
  • Syndicate to Micro.blog: Choose File > Publish > Post to Micro.blog… to send your document to your blog as a full post or excerpt.
  • Published Documents Library: Browse and search all your published documents with real-time fuzzy search, open local copies, import TextPacks from the server, or syndicate existing posts.

Marked automatically generates a TextPack version of your document for upload, complete with any external assets and included files, as well as a highlights.json file for your Reading Mode highlights and comments. You can retrieve documents as TextPack from the host, or export them directly from the web.

Marked Share is API-first. Everything Marked 3 does under the hood, like creating documents, uploading TextPack assets, managing collections, fetching highlight sets, and syndicating to Micro.blog is available through a straightforward REST API.

You can authenticate with an API token and interact with your library using standard HTTP requests:

# Upload a document as a multipart TextPack
curl -X POST "https://share.markedapp.com/api/v1/documents" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "file=@my-post.textpack" \
  -F "document[visibility]=unlisted" \
  -F "document[reading_style]=editorial"

Or quickly syndicate an existing document to Micro.blog:

curl -X POST "https://share.markedapp.com/api/v1/documents/PRIVATE_ID/microblog" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"format": "full"}'

Whether you want to build custom publishing scripts, hook it into a shortcut, or integrate it into a CMS, the API gives you total control.

Roadmap

The next major milestone for Marked Share is the ability to sync a folder to a collection via a local app or Dropbox so that it can function like SimpleNote (but with multiple folders), and eventually integrate with nvUltra in a seamless way.

I don’t plan to add multiple editors to a document at this point. Sync and conflict resolution is not something I want to tackle yet. I do plan to add additional review tools like multiple highlight colors, strikethrough, insertions, etc., all stored as sets from a reviewer that the owner can review and integrate if they want to (CriticMarkup style).

In the meantime, if you have any feedback, feature requests, or run into any issues, use the Support link at the top of the site to get to the Marked Support site. Be sure to indicate that you’re referring to Marked Share or specifically Marked 3 integration in your message.

Getting Started

Marked Share is live and ready to use. Head over to share.markedapp.com to create a free account, explore the Marked Share documentation for full details and API specs, and check out the Marked Share development log for a live example.