markdown-to-pdf

Markdown to PDF Converter Skill

This skill helps you convert Markdown files to PDF format with support for both document-style and presentation-style outputs using Marp.

When to Use This Skill

Use this skill when the user wants to:

• Convert Markdown (.md) files to PDF presentations
• Generate slide decks from Markdown
• Create professional PDFs from documentation
• Export README files as PDFs
• Generate presentation-ready slides with Marp themes

Available Conversion Methods

Method 1: Marp Presentation (Recommended)

Best for: Presentations, slide decks, visual content

Command:

python marp_to_pdf.py input.md

Features:

• Beautiful presentation slides from Markdown
• Multiple built-in themes (default, gaia, uncover)
• Automatic slide breaks with ---
• Support for presenter notes
• Code syntax highlighting
• Chinese/CJK character support
• Outputs: input.pdf

Method 2: Marp with Custom Theme

Best for: Branded presentations, custom styling

Command:

python marp_to_pdf.py input.md --theme gaia

Supported Themes:

• default - Clean and simple
• gaia - Modern and colorful
• uncover - Minimalist and elegant

Required Dependencies

The skill requires Marp CLI via npm:

# Install Node.js first (if not installed)
# Then install Marp CLI globally
npm install -g @marp-team/marp-cli

# Or use npx (no installation needed)
npx @marp-team/marp-cli --version

Marp Markdown Syntax

Basic Slide Structure

---
marp: true
theme: default
---

# Title Slide

Your presentation content

---

## Second Slide

- Bullet point 1
- Bullet point 2

---

## Code Example

\`\`\`python
def hello():
    print("Hello, World!")
\`\`\`

Slide Directives

<!-- _class: lead -->
# Centered Title Slide

<!-- _class: invert -->
## Inverted Color Slide

<!-- backgroundColor: #123456 -->
## Custom Background

Presenter Notes

## Slide Title

Slide content here

<!--
These are presenter notes
They won't appear in the PDF
-->