markdown-to-pdf

Convert Markdown files into PDF presentations and documents using Marp.

1|1|Updated Oct 24, 2025
One-click install
npx skills add https://github.com/yonggao/claude-plugins --skill markdown-to-pdf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-to-pdf
Source: https://github.com/yonggao/claude-plugins/tree/main/skills/markdown-to-pdf
Command: npx skills add https://github.com/yonggao/claude-plugins --skill markdown-to-pdf

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @marp-team/marp-cli.

What problem does it solve?

This Skill streamlines the creation of professional PDF presentations and documents directly from Markdown files. It eliminates the need for complex design software, allowing you to focus on content while ensuring beautiful, consistent output for your slides and reports.

Core Features & Use Cases

  • Presentation-Ready PDFs: Transform simple Markdown into visually appealing slide decks using Marp, complete with themes, code highlighting, and math equations.
  • Multiple Themes: Choose from built-in themes like default, gaia, or uncover to quickly style your presentations.
  • Code & Math Support: Render code blocks with syntax highlighting and display mathematical equations using KaTeX, perfect for technical documentation or academic presentations.
  • Use Case: Quickly convert your project's README.md into a professional PDF presentation for a team meeting, or turn a technical specification into a polished document for stakeholders.

Quick Start

Convert a Markdown file to a PDF presentation using the default theme

python ~/.claude/skills/markdown-to-pdf/marp_to_pdf.py presentation.md

Convert with a specific theme (e.g., 'gaia')

python ~/.claude/skills/markdown-to-pdf/marp_to_pdf.py slides.md --theme gaia

Frequently Asked Questions about markdown-to-pdf

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert Markdown files to PDF presentations?

Convert Markdown to PDF presentations using Marp by running `python ~/.claude/skills/markdown-to-pdf/marp_to_pdf.py your-file.md`. The Skill transforms Markdown into styled slide decks with built-in theme support, code highlighting, and math equation rendering.

What themes are available for Markdown to PDF conversion?

Marp supports multiple built-in themes including default, gaia, and uncover. Specify a theme during conversion with the `--theme` flag to quickly style your presentations without manual design work.

Can I use Markdown to PDF conversion for technical documentation with code and math?

Yes, the Skill renders code blocks with syntax highlighting and mathematical equations using KaTeX, making it ideal for technical specifications, academic presentations, and documentation that requires both executable code samples and mathematical notation.

Do I need Marp CLI installed to convert Markdown to PDF?

The Skill requires either Marp CLI or npx availability in your environment. It uses @marp-team/marp-cli as its dependency to generate PDF output from Markdown files.

What output formats does Markdown to PDF conversion support?

The Skill generates PDF outputs as primary format and supports optional HTML exports. It includes size reporting and error handling for reliable document generation.

Can Markdown to PDF handle Chinese and CJK characters?

Yes, the Skill includes Chinese and CJK character support, enabling you to create presentations and documents in multiple languages with proper rendering.