How do I use io.github.wmarceau/md-to-pdf?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@io.github.wmarceau/md-to-pdf convert README.md to PDF with table of contents" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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

This server cannot be installed

A

license - permissive license

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

io.github.wmarceau/md-to-pdf