# Exporting & sharing
Export Markdown to self-contained HTML
Last updated July 2026
To turn a Markdown file into HTML in Unmarked, open it, press ⇧⌘E, and choose HTML. You get one self-contained file with the CSS and images embedded, ready to put on the web or drop into an email. Prefer to bring your own styling? Pick the minimal-markup option instead. The conversion runs on your Mac. Nothing is uploaded.
Most "markdown to HTML" tools online want you to paste your text into a browser and trust their server with it. Unmarked does the conversion on the machine in front of you and hands you a finished file.
Export to HTML
- Open your Markdown file in Unmarked.
- Press ⇧⌘E, or choose File → Export.
- Pick HTML as the format.
- Choose where to save, then export.
You end up with a .html file you can open in any browser, attach to an email, or upload to a server.
Two kinds of HTML
"HTML" means two different things depending on what you're doing with it, so the export gives you both.
Self-contained is the default. The CSS that styles the page and any local images are written straight into the file, so it's a single document that carries everything it needs. Open it on another Mac, a Windows machine, or a phone and it looks the same, with no separate stylesheet or image folder to ship alongside it. Send this version in an email or hand it to someone who just needs to read it.
Minimal markup strips it back to clean, structural HTML with no embedded styling. Use it when the page is going into a site that already has its own stylesheet, or when you want to apply your own CSS. You get the headings, lists, tables, and code blocks as plain semantic tags, ready to inherit whatever design you drop them into.
Both come out of the same Export dialog. Pick the one that matches where the file is headed.
What carries over
The HTML matches what you see in Read mode. Headings, paragraphs, bold and italic, ordered and nested lists, task lists, blockquotes, inline code, fenced code blocks with their language label, links, and tables all come across as proper HTML elements. Export uses Unmarked's fixed style, so the self-contained version looks consistent whatever reading or writing font you've set in Settings.
Local images embed directly into the self-contained file, so it travels on its own with nothing to relink. A rendered Mermaid diagram embeds the same way, so the page still works offline.
Heads up: footnotes (
[^1]) and math ($…$) appear as plain text in the HTML, the same as on screen. Images linked from the web (https://…) come across as their alt text; images stored next to your file embed normally. (Why web images show as alt text.)
Formatted text for an email or chat
Pasting into Mail, Slack, Notion, or Google Docs? You don't need an export at all. Select your text and Copy as Rich Text (⌥⌘C). It pastes as clean formatted text with no Markdown symbols. To put the raw markup on your clipboard instead, copy as HTML.
Unmarked is a free, private Markdown reader and editor for Mac. Read the story , or get in touch.