convert_markdown
Convert markdown to Word/PDF with optional .dotx template.
This tool converts markdown files to professional documents using python-docx. You can optionally provide a .dotx template file for consistent styling.
LABSCO SUMMARY
Markdown to a branded Word document, with the PDF coming out of the same template.
The template is what this is for: apply a .dotx once and every document delivered afterwards matches it, instead of restyling by hand each time. Two things to plan around — PDF output depends on LibreOffice or Word being installed locally, and link text renders without being clickable in the output.
What it is
A converter from Markdown to .docx and .pdf, built on python-docx. Point it at a .dotx Word template and the output picks up that template's fonts, styles and layout.
What you get
- One markdown file converted to .docx, .pdf, or both, written to an output path you choose
- A .dotx Word template applied for consistent styling; without one, a clean default design is used
- Batch conversion of a list of markdown files under the same template and format, named after the inputs and written into one directory
- The supported input and output formats and features listed on request
- Headings, emphasis, lists, tables, code blocks and blockquotes rendered, with backgrounds and borders on code blocks and quotes
Requirements
No account and no key — it reads and writes files on your machine. Python 3.10 or newer; run it with uvx mcp-md-pdf, or pip install mcp-md-pdf and run python -m md_pdf_mcp.server. The PyPI package is mcp-md-pdf, currently 0.1.0. Producing Word documents needs nothing further, but PDF conversion needs a renderer on the machine: LibreOffice on macOS (brew install --cask libreoffice) or Linux (sudo apt-get install libreoffice), or Microsoft Word on Windows through COM automation, which also wants pywin32. There is no Docker image on purpose — the server takes absolute host paths, which a container cannot resolve.
Setup effort
One command — uvx mcp-md-pdf
USE CASES
01
Sending a client a document that looks like it came from your company
Convert the markdown with your .dotx template applied, and take the .docx and .pdf from the same run.
02
Converting a whole folder of notes at once
Pass the list of markdown files with one template and format; outputs are named after the inputs in the directory you name.
03
Getting a clean document out of notes with no template to hand
Convert without a template — the default design handles headings, lists, tables and code blocks.
04
Checking what will survive the conversion before you rely on it
Ask for the supported formats and features first.
3 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
convert_markdown_batch
Batch convert multiple markdown files to Word/PDF.
Converts a list of markdown files using the same template and format settings. Output files are named after input files and placed in the specified directory.
list_supported_formats
List all supported input/output formats and features.
Returns: Information about supported formats and features
BEFORE YOU INSTALL
What to know first
Tools you get
3 tools when we connected.
Requires
Python 3.10+
Where it runs
All 3 documented setups run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 3 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
uvx mcp-md-pdfMCP Clients
Claude Desktop — uvx
CLAUDE DESKTOP — UVX · JSON
{
"mcpServers": {
"md-pdf": {
"command": "uvx",
"args": [
"mcp-md-pdf"
]
}
}
}Claude Desktop — pip
CLAUDE DESKTOP — PIP · JSON
{
"mcpServers": {
"md-pdf": {
"command": "python",
"args": [
"-m",
"md_pdf_mcp.server"
]
}
}
}Claude Desktop — env variables
CLAUDE DESKTOP — ENV VARIABLES · JSON
{
"mcpServers": {
"md-pdf": {
"command": "python",
"args": [
"-m",
"md_pdf_mcp.server"
],
"env": {
"PYTHONPATH": "<YOUR_PATH_TO_MCP_MD_PDF>"
}
}
}
}
