Updated: Getting Started & Templates

Written and tested by the MD Converter editorial team

Markdown Document Converter Quick Start in 4 Steps

The fastest way to create HTML or PDF with Markdown Document Converter: load a file, check the preview, adjust layout, and export.

What you'll learn

This is the quick-start version. For the full feature reference, see How to Convert Markdown to HTML and PDF.


What you can do

FeatureDescription
HTML exportOne self-contained .html file with embedded styles
PDF exportSave as PDF via the browser print dialog
Live previewSee the rendered result immediately after import
Layout settingsMargins, fonts, line height, page breaks
Image embeddingPaste/drop images; they embed as Base64
Browser-only conversionLocal Markdown is not uploaded to this site's servers

Start in 4 steps

Step 1: Load your file

Choose one:

Supported: .md text files, up to 10 MB.

Step 2: Check the preview

After loading, the rendered result appears in the Preview pane. Verify headings, lists, tables, and code blocks look right.

The document opens directly in the rendered preview, where page boundaries and break controls match the PDF workflow.

Step 3: Adjust layout (optional)

Click Layout settings to open the panel:

Under Advanced: set print margins (mm per side) and page-break rules (e.g. break before h1, avoid splitting tables).

Step 4: Export


Privacy: your files stay in the browser

Local-file processing (load, convert, preview, download) runs entirely in your browser. Your Markdown is not uploaded to this site's servers for conversion. Remote images still contact their hosts, so follow your organization's policy when working with confidential documents.


FAQ

HTML or PDF — which should I use?

HTML for web or portal embedding; PDF for printing, sharing, or formal submission. Both are available from the same screen.

Will a page reload lose my work?

No. Your Markdown and layout settings are stored in the browser for the session and survive a reload.

Can I use images?

Yes. Drop an image onto the preview near the block where it belongs. It is embedded into the document and can be resized from a corner, aligned, or moved behind a page break. Formats: PNG, JPEG, GIF, and WebP. Limit: 5 MB per file.

How do I control page breaks?

Do not add page-break markup to the Markdown source. Instead, use Layout → Page breaks for document-wide rules and drag the break handles in Preview for fine-tuning. See Adjust page breaks by dragging in Preview.

Why does the PDF look different from the preview?

Reset the print dialog margin to default and zoom to 100%. For deeper diagnosis, see Why Markdown PDFs and Print Look Broken.

Can I start from a preset?

Yes. Before loading a file, choose a document preset for a specification, proposal, meeting notes, report, technical document, or minimal layout. It applies a cover, TOC choice, margins, numbering, and typography together. Use the CTA below the preset gallery to select the Markdown file.

How is the PDF filename chosen?

The tool proposes a safe filename from the cover title, first H1, or original Markdown filename, then adds the date and version when available. Review the suggestion in the save dialog before confirming.

Reopen the exported PDF and verify its first page, final page, links, images, and page count before sharing it.


Try the four steps