mdpdf README

Markdown to PDF with professional formatting control. Version 1.0.0

Every markdown to PDF tool out there is just awful. We want PDFs as beautiful as markdown viewers we use to generate source data. mdpdf uses headers and code inserts in markdown files to produce fantastic documents.

Quick Start

npm install
mdpdf document.md
# Output: document.pdf

Core Features (v1.0)

• Title page generation from frontmatter
• Auto-generated table of contents
• H1 headings can start on a new page with section numbering
• Orphan and widow control for clean page flow
• Code block line numbers
• Shiki syntax highlighting (14 themes)
• Header and footer templates with placeholders
• Configurable page size and margins
• Custom CSS injection
• Manual page breaks
• Watch mode with debounce

CLI

mdpdf <input> [options]

-o, --output <path>
-c, --config <path>
--page-numbers / --no-page-numbers
--css <path>
-w, --watch
--watch-delay <ms>

Frontmatter Example

---
title: "Quarterly Report"
subtitle: "Q1 2026 Results"
author: "Nathan"
date: 2026-03-06
toc: true
toc-depth: 2
page-numbers: true
---

# Executive Summary