Markdown转PDF转换器
将markdown(.md)文件转换为具有自动目录的专业交互式PDF文档。
mcp名称:io.github.wmarceau/md-to-pdf
特性
- 自动目录 -由markdown标题生成
- 交互式导航 -可点击的TOC链接到各部分
- 专业造型 -干净、可读的PDF输出
- 代码块支持 -保留语法高亮显示
- 桌架 -Markdown表格转换为PDF表格
- 图像支持 -PDF中的嵌入式图像
- 批量转换 -一次处理多个文件
- MCP集成 -用作人工智能助手的MCP服务器
用例
- 将文档转换为可共享的PDF
- 从markdown创建专业报告
- 生成带有导航功能的用户手册
- 以PDF格式存档降价内容
- 准备演示文稿或讲义
- 基于AI的文档生成工作流
项目结构
md-to-pdf/
├── src/
│ ├── md_to_pdf.py # Core conversion logic
│ └── convert.sh # Wrapper script (sets library paths)
├── mcp-server/
│ └── md_to_pdf_mcp.py # MCP server wrapper
├── registry/
│ └── manifest.json # MCP Registry manifest
├── workflows/
│ └── convert-md-to-pdf.md # Conversion workflow guide
├── testing/ # Multi-agent test infrastructure
├── VERSION # Current version
├── CHANGELOG.md # Version history
├── SKILL.md # MCP skill documentation
└── README.md # This file需求
- Python 3.8+
- markdown2(markdown解析)
- weasyprint(PDF生成)
- pygments(代码语法高亮显示)
- mcp(mcp服务器-仅适用于mcp模式)
macOS附加要求
brew install pango cairo快速开始
CLI使用情况
# Set library path (macOS)
export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH
# Convert single file
python src/md_to_pdf.py input.md output.pdf
# Using wrapper script
./src/convert.sh input.md output.pdf
# Batch convert
python src/md_to_pdf.py "docs/*.md" --output-dir pdfs/
# With custom styling
python src/md_to_pdf.py input.md output.pdf --css custom.css
# Without table of contents
python src/md_to_pdf.py input.md output.pdf --no-tocMCP服务器使用情况
# Install MCP SDK
pip install mcp
# Run MCP server
python mcp-server/md_to_pdf_mcp.pyMCP工具
| 工具 | 说明 |
|---|---|
convert_markdown_to_pdf | 使用可选的TOC将markdown转换为PDF |
extract_toc | 提取目录结构 |
get_default_styles | 获取默认CSS进行自定义 |
看 技能.md 了解详细的MCP工具文档。
版本
当前版本:1.0.0
许可证
MIT许可证
