Share Markdown as PDF or HTML with someone who doesn't use Markdown

Choose how to share a Markdown document: the source files, a single HTML file or a PDF, depending on whether the recipient needs to edit, read or print it.

Should you send Markdown, HTML or PDF?

Ask whether the recipient must edit, follow links, read offline, or approve a fixed version. A single PDF is convenient for reading and annotation, but it does not replace editable Markdown. A folder of .md files preserves source and relative links, but the recipient needs a compatible viewer. HTML can open in a browser, yet local assets may need to travel beside it.

Aero Markdown can print or export the rendered page as a PDF or a local HTML file, and Save writes the open Markdown file when you choose Save.

The Markdown Handoff Kit provides one fictional specification, its acceptance criteria, a manifest and a diagram. It intentionally contains source only. Make your own HTML or PDF copy and inspect it; do not assume the ZIP includes exports.

Send the testable package

For a source handoff, zip the complete folder and include a README telling the recipient where to start. For HTML, move the export to a fresh folder and check links and images. For PDF, inspect page breaks and verify that important text remains legible. Name the version and date of the delivered files so feedback points to the same revision.

There is no substitute for asking a real recipient whether they can find a requirement or open an attachment. This article does not claim such a user study has been run. To make a quick PDF or HTML copy of a single file without installing anything, use the free Markdown to PDF or HTML tool. The manual checklist, PDF guide and HTML guide cover each format in more detail.