Getting Started with Markdown to PDF

Markdown to Pretty PDF is a free, browser-based tool that converts plain Markdown text into polished, professional PDFs and HTML pages — without any software installation. This guide walks you through everything you need to get started in under five minutes.

What is Markdown?

Markdown is a lightweight markup language created by John Gruber in 2004. Instead of clicking buttons in a word processor, you write simple symbols alongside your text to indicate formatting:

• **bold** → bold
• *italic* → italic
• # Heading 1 → a large heading
• - item → a bullet list

The result is plain text that is both human-readable and machine-renderable — making it the standard format for READMEs, documentation, notes, and technical writing.

Step 1: Open the Editor

Navigate to the Editor page. You will see a split-panel interface:

• Left panel — your Markdown source
• Right panel — a live preview of the rendered output

Everything you type in the left panel is instantly reflected on the right.

Step 2: Write Your Content

Start typing Markdown. Here is a minimal example of a well-structured document:

# My Report

## Introduction

This report summarises the findings of the Q1 review cycle.

## Key Findings

- Revenue increased by 18% year-over-year
- Customer satisfaction score: **4.7 / 5**
- Operational costs reduced by $120,000

## Conclusion

The quarter exceeded expectations across all key metrics.

Step 3: Add Diagrams (Optional)

You can embed live diagrams directly in your Markdown using fenced code blocks. For example, a simple flowchart using Mermaid:

Mermaid

Supported diagram types include Mermaid, PlantUML, Graphviz, D2, and many more.

Step 4: Export to PDF

Click the Export PDF button in the toolbar. The system generates a high-fidelity PDF using the same layout you see in the preview. Key things to know:

• Page size defaults to A4. You can adjust this in settings.
• Fonts and colours match the selected theme.
• Diagrams render as crisp vector graphics — they look sharp at any zoom level.
• Math expressions (KaTeX) render correctly in the exported PDF.

Step 5: Share Your Document

Click Share to generate a public link to your document. Anyone with the link can view the rendered HTML version in their browser — no account required.

Tips for Great Output

Next Steps

• Read the Markdown Cheatsheet for a full syntax reference
• Learn how to add a Table of Contents to your document
• Explore PDF Export Tips for pixel-perfect output