md-to-pdf-mcp 1.0.1

Convert markdown to professional PDFs with clickable table of contents. No API keys.

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