Markdown转PDF工具

将Markdown文件转换为具有自动目录的专业交互式PDF文档。

  • by MarceauSolutions
  • Python
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 MarceauSolutions/md-to-pdf-mcp

使用说明

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-toc

MCP服务器使用情况

# Install MCP SDK
pip install mcp

# Run MCP server
python mcp-server/md_to_pdf_mcp.py

MCP工具

工具 说明
convert_markdown_to_pdf 使用可选的TOC将markdown转换为PDF
extract_toc 提取目录结构
get_default_styles 获取默认CSS进行自定义

看 技能.md 了解详细的MCP工具文档。

版本

当前版本:1.0.0

许可证

MIT许可证