📄 Markdown2PDF Skill

A professional OpenClaw skill for converting Markdown documents to PDF and PNG with colored emoji support.

📋 Overview

✨ Features

• 📄 Markdown to PDF - Professional PDF document generation
• 🖼️ Markdown to PNG - High-quality PNG image generation
• 🎨 5 Professional Themes - default, dark, github, minimal, professional
• 🌈 Colored Emoji Support - Automatic emoji to colored text label conversion
• ✨ Custom CSS - Complete style control
• 🚀 CLI & API - Multiple usage methods
• 🧩 OpenClaw Integration - Seamless integration

🚀 Quick Start

Installation

cd ~/.openclaw/workspace/skills/markdown2pdf
pip3 install markdown pdfkit imgkit
brew install wkhtmltopdf  # macOS
# or
sudo apt-get install wkhtmltopdf  # Ubuntu

Basic Usage

# Convert to PDF
python3 src/converter.py input.md -f pdf

# Use theme
python3 src/converter.py README.md -t github -f pdf

# List themes
python3 src/converter.py --list-themes

🎨 Available Themes

🌈 Colored Emoji Support

Automatically converts emoji to colored text labels for PDF compatibility:

📖 API Usage

Python API

from src.converter import convert_markdown_to_pdf, MarkdownConverter

# Simple conversion
pdf_path = convert_markdown_to_pdf(
    markdown_text="# Hello World",
    output_filename="hello.pdf",
    theme="github"
)

# Advanced usage
converter = MarkdownConverter(
    output_dir=Path("./output"),
    theme="professional",
    custom_css=".custom { color: red; }"
)

pdf_path = converter.convert_to_pdf(
    markdown_text="# Document",
    output_filename="doc.pdf",
    page_size="A4",
    margin="15mm"
)

⚙️ Configuration

Default Settings

📦 Dependencies

📁 Project Structure

markdown2pdf/
├── src/
│   ├── converter.py          # Main converter
│   └── emoji_replacer.py     # Emoji conversion utility
├── output/                    # Output files
├── tests/
│   └── test_converter.py     # Test suite
├── README.md                  # Documentation
├── SKILL.md                   # This file
└── requirements.txt           # Dependencies

🧪 Testing

# Run tests
pytest tests/

# Test conversion
python3 src/converter.py test_document.md -t github -f pdf

📝 Changelog

v1.0.0 (2026-03-16)

Initial Stable Release

• ✨ Markdown to PDF/PNG converter
• 🎨 5 professional themes
• 🌈 Colored emoji support
• 🔧 CLI and API interfaces
• 📚 Complete documentation
• 🧩 OpenClaw integration

🎯 Use Cases

1. Investment Analysis Reports

python3 src/converter.py stock_analysis.md -t professional -f pdf

2. Technical Documentation

python3 src/converter.py README.md -t github -f pdf,png

3. Presentations

python3 src/converter.py presentation.md -t dark -f png --width 1920

4. Business Reports

python3 src/converter.py business_report.md -t professional -f pdf

📞 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Repository: GitHub

📄 License

MIT License - See LICENSE file for details.

Happy Converting! 📄🎨

Last Updated: 2026-03-17
Version: 1.0.0
Author: PocketAI for Leo