Markdown to PDF Converter

Convert markdown (.md) files into professional, interactive PDF documents with automatic table of contents.

mcp-name: io.github.wmarceau/md-to-pdf

Features

Automatic Table of Contents - Generated from markdown headers
Interactive Navigation - Clickable TOC links to sections
Professional Styling - Clean, readable PDF output
Code Block Support - Syntax highlighting preserved
Table Support - Markdown tables convert to PDF tables
Image Support - Embedded images in PDFs
Batch Conversion - Process multiple files at once
MCP Integration - Use as an MCP server for AI assistants

Use Cases

Convert documentation to shareable PDFs
Create professional reports from markdown
Generate user manuals with navigation
Archive markdown content in PDF format
Prepare presentations or handouts
AI-powered document generation workflows

Project Structure

md-to-pdf/
├── src/
│   ├── md_to_pdf.py          # Core conversion logic
│   └── convert.sh            # Wrapper script (sets library paths)
├── mcp-server/
│   └── md_to_pdf_mcp.py      # MCP server wrapper
├── registry/
│   └── manifest.json         # MCP Registry manifest
├── workflows/
│   └── convert-md-to-pdf.md  # Conversion workflow guide
├── testing/                  # Multi-agent test infrastructure
├── VERSION                   # Current version
├── CHANGELOG.md              # Version history
├── SKILL.md                  # MCP skill documentation
└── README.md                 # This file

Requirements

Python 3.8+
markdown2 (markdown parsing)
weasyprint (PDF generation)
pygments (code syntax highlighting)
mcp (MCP server - for MCP mode only)

macOS Additional Requirements

brew install pango cairo

Quick Start

CLI Usage

# Set library path (macOS)
export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH
 
# Convert single file
python src/md_to_pdf.py input.md output.pdf
 
# Using wrapper script
./src/convert.sh input.md output.pdf
 
# Batch convert
python src/md_to_pdf.py "docs/*.md" --output-dir pdfs/
 
# With custom styling
python src/md_to_pdf.py input.md output.pdf --css custom.css
 
# Without table of contents
python src/md_to_pdf.py input.md output.pdf --no-toc

MCP Server Usage

# Install MCP SDK
pip install mcp
 
# Run MCP server
python mcp-server/md_to_pdf_mcp.py

MCP Tools

Tool	Description
`convert_markdown_to_pdf`	Convert markdown to PDF with optional TOC
`extract_toc`	Extract table of contents structure
`get_default_styles`	Get default CSS for customization

See SKILL.md for detailed MCP tool documentation.

Version

Current version: 1.0.0

License

MIT License

MarceauSolutions/md-to-pdf-mcp