Written and tested by the MD Converter editorial team
Create a PDF with Markdown Document Converter in Five Minutes
Pick a preset, import Markdown, check the preview, adjust margins and page breaks, then save your first PDF with Markdown Document Converter in five practical steps.
The five-step workflow
The Markdown to PDF tool creates PDFs in your browser without installing an app or creating an account:
- Pick a preset (optional).
- Import Markdown.
- Check the preview.
- Adjust margins, page numbers, and page breaks.
- Click "Save as PDF" and select a PDF destination in the print dialog.
Conversion runs locally in your browser; your document does not need to be uploaded for conversion.
1. Start with a document preset (optional)
Before importing, "Choose a layout by purpose" offers Specification, Proposal, Meeting notes, Report, Technical doc, and Minimal presets. A preset sets the cover, TOC, margins, page numbers, background color, font size, and line height together.
If you are unsure, start with Specification for structured internal documents or Minimal for a short handout. You can skip presets and set the cover and margins individually later.
2. Import Markdown
Use one of these options:
- "Choose file" to open a
.mdfile, or drop it onto the page (up to 10 MB) - "Paste Markdown" to paste and import text (up to 2 MB)
- "No file? Try a sample" to open an example document
- "More ways to import" for a public GitHub URL, a Markdown + image folder, or a Markdown + image ZIP
If your Markdown references images by relative path, import the folder or ZIP so they display. Imported Markdown is read-only in the tool, so edit the original .md and import it again to change the text. For the basics from import to export, see the Markdown Document Converter Quick Start in 4 Steps.
3. Check the preview
The preview is split into A4 portrait pages. Confirm that GFM features such as headings, lists, tables, fenced code, task lists, and Mermaid diagrams render as expected.
Use the page strip on the left to jump to the cover, TOC, or any page. Content that does not fit on a page is outlined in orange, so you can see where to look before saving.
4. Adjust margins, page numbers, and page breaks
Check these three toolbar settings first:
| Setting | Starting point |
|---|---|
| Margin | Choose 10 to 30 mm; 15 to 20 mm if unsure |
| Page numbers (1/n) | On for multi-page documents |
| Background color | Keep white for printed documents |
Then review the page boundaries. If a heading is stranded at the bottom of a page, click that heading's block to insert a break before it. Drag the ⋮⋮ handle to move an existing break. Tables and code blocks are set by default to avoid splitting across pages where possible.
Select an image to resize it and align it left, center, or right. If an adjustment makes things worse, use Undo, Redo, or the history button to step back.
5. Save and inspect the PDF
Click "Save as PDF" at the bottom, choose a PDF destination in your browser or OS print dialog, and select a filename.
Before saving, check that:
- Paper is A4 and scale is 100%
- The dialog margin starts at None so it does not add to the tool's margin
- Headers and footers are off
- "Background graphics" is on if you use a page color or a colored cover
Output can vary by browser and OS; Google Chrome is recommended when consistent layout is important.
Add a cover and table of contents
Click "Cover" in the page strip to open the cover panel. Choose a template and enter the title, organization, date, and version. Make sure no preset or sample values remain.
Click "TOC" and turn on "Add a table of contents page" to build a contents page from your headings. The TOC is available when a cover is on, and it lists ## and ### headings. Heading edits change pagination, so finalize the structure before fine page-break work.
Common first-time problems
If the PDF looks smaller than expected, check the print dialog's scale and margins. If a cover background or band turns white, enable "Background graphics". If page numbers appear twice, turn off the browser's headers and footers.
Do not stop at clicking Save. Open the PDF and check through the last page, because remote images, links, and non-Latin fonts can differ from the preview.
First-export checklist
- The expected preset and cover are active.
- Cover metadata contains no sample values.
- TOC headings match the body.
- No heading is stranded at a page bottom.
- Tables, code, and images fit the printable width.
- Page numbers do not overlap content.
- The saved PDF opens and its final page is correct.
How to Print Markdown or Save It as PDF covers the full workflow, and the complete PDF preflight checklist covers checks before external distribution.