ghpdf

A CLI tool to convert Markdown files to PDF with GitHub-style rendering.

Installation

pip install ghpdf

Or with pipx (recommended for CLI tools):

pipx install ghpdf

Quick Start

# Convert a file
ghpdf README.md -o output.pdf

# Auto-name output (README.md → README.pdf)
ghpdf README.md -O

Usage

ghpdf [OPTIONS] [FILES]...

Options

Examples

# Single file with explicit output
ghpdf README.md -o documentation.pdf

# Auto-name output (README.md → README.pdf)
ghpdf README.md -O

# Bulk convert all markdown files
ghpdf *.md -O

# With page numbers
ghpdf report.md -O -n

# Stdin to file
echo "# Hello World" | ghpdf -o hello.pdf

# Stdin to stdout (for piping)
cat document.md | ghpdf > output.pdf

# Quiet mode for scripting
ghpdf *.md -O -q

Features

• GitHub-flavored markdown styling
• Syntax highlighting for code blocks
• Tables, task lists, footnotes, and more
• Page break support
• Optional page numbers
• Bulk conversion
• Stdin/stdout piping

Supported Markdown

Headings, bold, italic, strikethrough, lists, task lists, code blocks, inline code, tables, blockquotes, horizontal rules, links, images, footnotes, definition lists, abbreviations, and admonitions.

Page Breaks

Insert page breaks using any of these formats:

---pagebreak---
<!-- pagebreak -->
\pagebreak

License

MIT