Markdown2PDF MCP Server (markdown2pdf-mcp)

What is Markdown2PDF MCP Server (markdown2pdf-mcp)?

An MCP server for converting Markdown documents to PDF files. It uses Chrome’s rendering engine (via Puppeteer) and supports syntax highlighting, custom CSS, optional page numbers, watermarks, and Mermaid diagrams. Designed for developers using MCP‑aware clients (e.g., Cline, Claude Desktop).

How to use Markdown2PDF MCP Server (markdown2pdf-mcp)?

Install via npm install markdown2pdf-mcp or from source. Start the server with npm start or run on demand with npx -y markdown2pdf-mcp@latest. Configure the output directory via the M2P_OUTPUT_DIR environment variable in your MCP settings. Use the tool create_pdf_from_markdown with required markdown content and optional parameters like outputFilename, paperFormat, paperOrientation, paperBorder, watermark, watermarkScope, and showPageNumbers.

Key features of Markdown2PDF MCP Server (markdown2pdf-mcp)

• Convert Markdown to PDF with a single command
• Syntax highlighting for code blocks
• Custom CSS styling for PDF output
• Mermaid diagram rendering
• Optional page numbers in the PDF footer
• Watermarks configurable to first page or all pages
• Large file support with dynamic timeouts and 4GB memory

Use cases of Markdown2PDF MCP Server (markdown2pdf-mcp)

• Generate PDF reports from Markdown documentation
• Create PDFs with watermarked “DRAFT” or “CONFIDENTIAL”
• Produce styled PDFs with custom page sizes (A4, letter, etc.)
• Embed Mermaid diagrams in generated PDFs
• Automate PDF generation in MCP‑based workflows

FAQ from Markdown2PDF MCP Server (markdown2pdf-mcp)

What Markdown elements are not supported?

LaTeX math equations (e.g., $x^2$ or $$\sum_{i=1}^n x_i$$) and complex mathematical formulas are not supported.

How do I configure the output directory?

Set the M2P_OUTPUT_DIR environment variable in your MCP settings file. If not configured, PDFs are saved to $HOME.

Can I add a watermark to my PDF?

Yes. Use the watermark parameter (max 15 characters, uppercase) and set watermarkScope to 'first-page' or 'all-pages' (default).

What are the limits for large files?

Maximum file size is 10 MB. The tool automatically scales timeouts (up to 5 minutes) and allocates 4 GB memory for Chrome to handle complex documents.

Which Chrome version is used for PDF generation?

The package bundles Chrome v131.0.6778.204, which is automatically installed during npm install.