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

Related MCP server: Markdown2PDF MCP Server

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

See SKILL.md for detailed MCP tool documentation.

Version

Current version: 1.0.0

License

MIT License