What is Markdown2pdf Mcp

markdown2pdf-mcp is an MCP server designed for converting Markdown documents into PDF files efficiently. It supports syntax highlighting and custom styling, making it easy to generate professional-quality PDFs from Markdown content.

Use cases

Use cases for markdown2pdf-mcp include generating technical documentation, creating printable reports, converting Markdown notes into PDFs for sharing, and producing styled educational materials.

How to use

To use markdown2pdf-mcp, clone the repository, install the dependencies, and start the server. You can then utilize the create_pdf_from_markdown tool to convert your Markdown content into a PDF by specifying required and optional parameters.

Key features

Key features include single-command conversion of Markdown to PDF, syntax highlighting for code blocks, custom CSS styling, support for standard Markdown formatting, modern PDF generation using Chrome’s rendering engine, and reliable resource loading.

Where to use

markdown2pdf-mcp can be used in various fields such as documentation generation, report creation, educational materials, and any scenario where Markdown content needs to be converted into a polished PDF format.

Markdown2PDF MCP Server (markdown2pdf-mcp)

An MCP server for converting Markdown documents to PDF files. This server provides a simple and efficient way to generate PDFs from Markdown content with support for syntax highlighting and custom styling. Also allows for watermarking on page 1.

Inspired by Alan Shaw’s markdown-pdf.

Features

• Convert Markdown to PDF with a single command
• Syntax highlighting for code blocks
• Custom CSS styling for PDF output
• Support for standard Markdown formatting
• Modern PDF generation using Chrome’s rendering engine
• Excellent support for modern web features and fonts
• Reliable resource loading and rendering

Limitations

The following markdown elements are not supported:

• LaTeX math equations (e.g., $x^2$ or $$\sum_{i=1}^n x_i$$)
• Complex mathematical formulas or scientific notation

Stick to these supported markdown elements:

• Headers (all levels)
• Text formatting (bold, italic, strikethrough)
• Lists (ordered and unordered)
• Code blocks with syntax highlighting
• Tables
• Blockquotes
• Links
• Images (both local files and external URLs)
• Task lists

Installation

# Clone the repository
git clone https://github.com/2b3pro/markdown2pdf-mcp.git

# Navigate to the project directory
cd markdown2pdf-mcp

# Install dependencies
npm install

# Build the project
npm run build

Usage

Starting the Server

npm start

Using the MCP Tool

The server provides a single tool create_pdf_from_markdown with the following parameters:

{
  // Required parameters
  markdown: string;    // Markdown content to convert

  // Optional parameters with defaults
  outputFilename?: string;  // Filename for the PDF (e.g., "output.pdf")
  paperFormat?: string;     // 'letter' (default), 'a4', 'a3', 'a5', 'legal', 'tabloid'
  paperOrientation?: string; // 'portrait' (default), 'landscape'
  paperBorder?: string;     // '2cm' (default), accepts decimal values with CSS units (e.g., '1.5cm', '2.5mm', '0.5in', '10.5px')
  watermark?: string;       // Optional watermark text (max 15 characters, uppercase)
}

Example with options:

await use_mcp_tool({
  server_name: "markdown2pdf",
  tool_name: "create_pdf_from_markdown",
  arguments: {
    markdown: "# Hello World\n\nThis is a test document.",
    outputFilename: "output.pdf",
    paperFormat: "a4",
    paperOrientation: "landscape",
    paperBorder: "1.5cm",
    watermark: "DRAFT",
  },
});

Example minimal usage:

await use_mcp_tool({
  server_name: "markdown2pdf",
  tool_name: "create_pdf_from_markdown",
  arguments: {
    markdown: "# Hello World\n\nThis is a test document.",
    outputFilename: "output.pdf",
  },
});

Configuration

Output Directory

You can configure the output directory in your MCP settings file for apps that use MCP such as Cline or Claude. If not configured, it will save files to $HOME:

{
  "mcpServers": {
    "markdown2pdf": {
      "command": "node",
      "args": [
        "path/to/markdown2pdf-mcp/build/index.js"
      ],
      "env": {
        "M2P_OUTPUT_DIR": "/path/to/output/directory"
      }
    }
  }
}

The tool automatically handles file name conflicts by appending incremental numbers (e.g., output.pdf, output-1.pdf, output-2.pdf).

Dependencies

• @modelcontextprotocol/sdk - MCP SDK for server implementation
• remarkable - Markdown parser
• highlight.js - Syntax highlighting
• puppeteer - Modern PDF generation using Chrome for Testing (v131.0.6778.204)

Chrome Version

This package uses Chrome v131.0.6778.204 for consistent PDF generation across all installations. This version is automatically installed when you run npm install.

• tmp - Temporary file handling

Development

# Build the project
npm run build

# Start the server
npm start

License

MIT

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request