Markdown to PDF Converter

1# Markdown to PDF Converter
2 
3Convert markdown (.md) files into professional, interactive PDF documents with automatic table of contents.
4 
5mcp-name: io.github.wmarceau/md-to-pdf
6 
7## Features
8 
9- **Automatic Table of Contents** - Generated from markdown headers
10- **Interactive Navigation** - Clickable TOC links to sections
11- **Professional Styling** - Clean, readable PDF output
12- **Code Block Support** - Syntax highlighting preserved
13- **Table Support** - Markdown tables convert to PDF tables
14- **Image Support** - Embedded images in PDFs
15- **Batch Conversion** - Process multiple files at once
16- **MCP Integration** - Use as an MCP server for AI assistants
17 
18## Use Cases
19 
20- Convert documentation to shareable PDFs
21- Create professional reports from markdown
22- Generate user manuals with navigation
23- Archive markdown content in PDF format
24- Prepare presentations or handouts
25- AI-powered document generation workflows
26 
27## Project Structure
28 
29```
30md-to-pdf/
31├── src/
32│   ├── md_to_pdf.py          # Core conversion logic
33│   └── convert.sh            # Wrapper script (sets library paths)
34├── mcp-server/
35│   └── md_to_pdf_mcp.py      # MCP server wrapper
36├── registry/
37│   └── manifest.json         # MCP Registry manifest
38├── workflows/
39│   └── convert-md-to-pdf.md  # Conversion workflow guide
40├── testing/                  # Multi-agent test infrastructure
41├── VERSION                   # Current version
42├── CHANGELOG.md              # Version history
43├── SKILL.md                  # MCP skill documentation
44└── README.md                 # This file
45```
46 
47## Requirements
48 
49- Python 3.8+
50- markdown2 (markdown parsing)
51- weasyprint (PDF generation)
52- pygments (code syntax highlighting)
53- mcp (MCP server - for MCP mode only)
54 
55### macOS Additional Requirements
56 
57```bash
58brew install pango cairo
59```
60 
61## Quick Start
62 
63### CLI Usage
64 
65```bash
66# Set library path (macOS)
67export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH
68 
69# Convert single file
70python src/md_to_pdf.py input.md output.pdf
71 
72# Using wrapper script
73./src/convert.sh input.md output.pdf
74 
75# Batch convert
76python src/md_to_pdf.py "docs/*.md" --output-dir pdfs/
77 
78# With custom styling
79python src/md_to_pdf.py input.md output.pdf --css custom.css
80 
81# Without table of contents
82python src/md_to_pdf.py input.md output.pdf --no-toc
83```
84 
85### MCP Server Usage
86 
87```bash
88# Install MCP SDK
89pip install mcp
90 
91# Run MCP server
92python mcp-server/md_to_pdf_mcp.py
93```
94 
95## MCP Tools
96 
97| Tool | Description |
98|------|-------------|
99| `convert_markdown_to_pdf` | Convert markdown to PDF with optional TOC |
100| `extract_toc` | Extract table of contents structure |
101| `get_default_styles` | Get default CSS for customization |
102 
103See [SKILL.md](SKILL.md) for detailed MCP tool documentation.
104 
105## Version
106 
107Current version: 1.0.0
108 
109## License
110 
111MIT License
112