Markdown2PDF
About
Converts Markdown to PDF using Puppeteer, offering syntax highlighting, custom styling, and watermarking capabilities for document generation.
Details
- Author
- 2b3pro
- GitHub stars
- 36
- Downloads
- 522
- Categories
- Developer Tools, Other, Design, Workplace, File Management, AI, Knowledge Base, Frontend, Infrastructure
- Tags
- #document, #file-conversion, #pdf
Jump to
- Convert Markdown to PDF with a single command
- Syntax highlighting for code blocks
- Custom CSS styling for PDF output
- Support for standard Markdown formatting
- Mermaid diagram rendering
- Modern PDF generation using Chrome's rendering engine
- Excellent support for modern web features and fonts
- Reliable resource loading and rendering
- Optional page numbers rendered via the PDF footer
- Watermarks with configurable scope (first page or all pages)
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Markdown2PDFCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"markdown2pdf": {
"markdown2pdf-mcp": {
"command": "npx",
"args": [
"-y",
"markdown2pdf-mcp@latest"
]
}
}
}
}
McpServers
{
"markdown2pdf-mcp": {
"command": "npx",
"args": [
"-y",
"markdown2pdf-mcp@latest"
]
}
}
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, custom styling, optional page numbers, and flexible watermark placement (first page only or all pages).
Inspired by Alan Shaw'smarkdown-pdf.
- Convert Markdown to PDF with a single command
- Syntax highlighting for code blocks
- Custom CSS styling for PDF output
- Support for standard Markdown formatting
- Mermaid diagram rendering
- Modern PDF generation using Chrome's rendering engine
- Excellent support for modern web features and fonts
- Reliable resource loading and rendering
- Optional page numbers rendered via the PDF footer
- Watermarks with configurable scope (first page or all pages)
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
- Mermaid diagrams
To render a Mermaid diagram, use amermaidcode block:
graph TD; A-->B; A-->C; B-->D; C-->D;
If there is a syntax error in your diagram, the error message will be rendered in the PDF, helping you to debug it.
# 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
The server provides a single toolcreate_pdf_from_markdownwith 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) watermarkScope?: 'all-pages' | 'first-page'; // Defaults to 'all-pages' showPageNumbers?: boolean; // Defaults to false }
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", watermarkScope: "first-page", showPageNumbers: true, }, });
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", }, });
You can run the server without a permanent local install by askingnpxto grab the latest package and execute its entrypoint:
This command installs the package into a temporary workspace and then starts the MCP server via its bundled CLI. Point your MCP-aware client (e.g., Cline or Claude Desktop) to this command to spin up the server on demand.
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": { "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).
The tool automatically handles large markdown files with:
- Dynamic Timeouts: Automatically scales based on content size (up to 5 minutes for very large files)
- Memory Limits: 4GB memory allocation for Chrome to handle complex documents
- Size Validation: Maximum 10MB file size with clear error messages
- Progress Tracking: Shows content size and estimated processing time
For very large files (1300+ lines), the tool will:
- Warn you about extended processing time
- Automatically increase timeouts
- Display content size in the response
- Provide detailed error messages if processing fails
{ "mcpServers": { "markdown2pdf": { "command": "node", "args": ["/path/to/markdown2pdf-mcp/build/index.js"], "env": { "M2P_OUTPUT_DIR": "/path/to/output/directory", "M2P_VERBOSE": "true" } } } }
This will log processing steps to stderr without interfering with MCP communication.
Prefer a locally built version? Swap"command"back tonodeand point"args"to the compiledbuild/index.jspath instead of usingnpx, for example:"args": ["/path/to/markdown2pdf-mcp/build/index.js"].
- @modelcontextprotocol/sdk- MCP SDK for server implementation
- remarkable- Markdown parser
- highlight.js- Syntax highlighting
- puppeteer- Modern PDF generation usingChrome for Testing(v131.0.6778.204)
This package uses Chrome v131.0.6778.204 for consistent PDF generation across all installations. This version is automatically installed when you runnpm install.
# Build the project npm run build # Start the server npm start
- Fork the repository
- Create your feature branch (git checkout -b feature/amazing-feature)
- Commit your changes (git commit -m 'Add some amazing feature')
- Push to the branch (git push origin feature/amazing-feature)
- Open a Pull Request
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Converts LaTeX source code into professionally formatted PDF documents.
Parses PDF files from a URL into structured formats like JSON and Markdown.
Create PDFs from Markdown, fill forms, merge, split, rotate, watermark, encrypt, extract text, and add QR codes. 16 tools, TypeScript-native.
Universal document generation and conversion MCP. Generate PDF/DOCX/XLSX from templates+JSON (invoices, contracts, reports), batch generation, 100+ format conversions.
A server for reading and converting documents between PDF, DOCX, and Markdown formats using marker-pdf and pandoc.
Convert, compress, merge and OCR PDFs and 100+ file formats from any AI agent — 126 tools via the GuruPDF API.
Convert PDF bank statements to checked Excel, CSV, or JSON with balance validation.
Converts various file types and web content, such as PDFs, images, audio, and web pages, into Markdown format.
Convert Markdown files to high-quality, print-ready PDFs using LaTeX.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





