Give the reader one file, not a folder to assemble.
A Markdown document may rely on a sibling image folder. Standalone HTML packages the rendered document and accessible local images into one browser-readable file. Remote images you approve for export can be embedded too.
Before and after
Before
Project update.md
Project update-assets/
└── chart.png
After export
Project update.htmlThe HTML copy contains the rendered text and embedded image data. Your original .md file and assets remain available for editing.
This is a file you can send, not a hosted page or a public web address. The recipient opens the downloaded HTML in a browser.
Export the document in Zizeg.
- Open and check the Markdown.If Zizeg is your default .md app, double-click the file. Read it in Preview, or use Split to inspect the source beside it; your chosen default view opens automatically. Make sure local images appear correctly.
- Choose File → Export → Export to HTML…Give the new file a name and choose its destination.
- Choose what belongs in the export.Leave Include front matter unchecked unless the document’s metadata should be visible. If remote images are present, choose which to embed.
- Open the exported file in a browser.Check the headings, lists, tables, and images before sending it.
Opening and reading Markdown are free. Editing and HTML or PDF export require a one-time purchase or an active subscription.
The export uses the document currently open, including recent edits, and follows your Preview typography. It leaves the editable Markdown source in place.
Not sure what the opening metadata is for? See the YAML front matter guide for a worked example and how to edit it in Source.
Know what travels inside the file.
Accessible local images and approved remote images are embedded as data. That means a displayed chart or screenshot doesn’t have to travel as a separate asset file with the HTML copy.
Ordinary links are different. A web link still leads to its website; a link to another local document does not become an embedded copy of that document. Include separately linked files when the recipient needs them.
Unapproved or failed remote images become placeholders instead of remaining live image URLs. The export is self-contained for its rendered content and embedded images, not an archive of every linked resource.
Choose HTML for reading without fixed pages.
Standalone HTML is useful for a report, handover note, or reference document someone will read in a browser. PDF is usually the clearer choice for a fixed-page deliverable or printing. Markdown is the better handoff when the recipient needs to keep editing the source.
See Markdown, PDF, or HTML: which should you send? for the decision table and examples.
You can have Zizeg open finished exports automatically under Preferences → Export, making the final check part of your routine.