Converts Markdown documents into professional PDF files, supporting standard syntax along with embedded Mermaid diagrams and custom CSS styling.
Renders standalone Mermaid diagram code into high-quality PNG images or PDF documents, supporting various diagram types like flowcharts and sequence diagrams.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Markdown + Mermaid to PDF MCP Serverconvert my documentation.md file into a PDF"
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 + Mermaid to PDF MCP Server
An MCP (Model Context Protocol) server that converts Markdown files containing Mermaid diagrams into PDF documents, and also converts standalone Mermaid diagrams to PNG or PDF. The server uses a hybrid approach: converting Markdown to HTML, rendering Mermaid diagrams as SVG graphics, and then generating outputs using Puppeteer.
Features
Converts Markdown files with Mermaid diagrams to PDF
Converts standalone Mermaid diagram code to PNG images
Converts standalone Mermaid diagram code to PDF files
Automatically renders Mermaid diagrams as high-quality SVG graphics
Clean, professional default styling
Support for custom CSS styling (for Markdown conversion)
Simple MCP tool interface
Installation
Usage
As an MCP Server
Add this server to your MCP client configuration (e.g., Claude Desktop):
Tool: convert_md_to_pdf
Converts a Markdown file with Mermaid diagrams to PDF.
Parameters:
input_path(required): Absolute path to the input Markdown fileoutput_path(optional): Absolute path where the PDF should be saved. If not provided, uses the same name as input with.pdfextensioncustom_css(optional): Additional CSS styles to apply to the PDF
Example:
Tool: convert_mermaid_to_png
Converts a standalone Mermaid diagram code to a PNG image file.
Parameters:
mermaid_code(required): Raw Mermaid diagram code as a stringoutput_path(required): Absolute path where the PNG file should be saved
Example:
Tool: convert_mermaid_to_pdf
Converts a standalone Mermaid diagram code to a PDF file.
Parameters:
mermaid_code(required): Raw Mermaid diagram code as a stringoutput_path(required): Absolute path where the PDF file should be saved
Example:
How It Works
Markdown Parsing: Reads and parses Markdown content using the
markedlibraryHTML Generation: Converts Markdown to HTML while preserving Mermaid code blocks
Mermaid Rendering: Injects Mermaid.js library to render diagrams as SVG in the browser
PDF Export: Uses Puppeteer (headless Chrome) to generate the final PDF with all content rendered
Example Markdown
See example.md for a sample document with Mermaid diagrams.
Development
Requirements
Node.js 18 or higher
Sufficient memory for Puppeteer to run headless Chrome
License
MIT