md2pdf-converter
by tianxingleo
Git & GitHubBrief
Offline Markdown to PDF converter with FULL Unicode support using Pandoc + WeasyPrint + local Twemoji cache (3660.
Description
What This Skill Does
Converts Markdown documents to PDF with full Unicode support, CJK font rendering, and colorful emojis using Pandoc, WeasyPrint, and a local Twemoji 14.0.0 cache. Works offline after an initial ~150MB download on first run.
Most Markdown-to-PDF tools either drop CJK characters or render emojis as black-and-white glyphs; this combines Pandoc, WeasyPrint, and a locally cached Twemoji set to handle both correctly offline.
When to Use It
- Converting Markdown reports with Chinese or Japanese text to PDF
- Exporting documents containing emojis as colorful PDFs
- Generating technical docs with code blocks and tables as PDFs
- Offline PDF conversion after initial setup
- Producing PDFs from CJK-heavy content with correct font rendering
Example Workflow
User asks: Convert report.md to report.pdf
- 1
Run md2pdf-local.sh, which downloads Twemoji 14.0.0 (~150MB) to ~/.cache/md2pdf/ on first use
- 2
Python script scans the cached PNG files and generates emoji_mapping.json
- 3
Pandoc converts Markdown to HTML, applying a Lua filter that replaces emoji characters with local image paths
- 4
WeasyPrint renders the HTML to PDF using AR PL UMing CN for CJK characters and local emoji PNGs
report.pdf with correct Chinese characters, colorful emojis, code highlighting, and page numbers
Requirements
- Pandoc installed
- WeasyPrint installed (pip3 install weasyprint or apt-get install python3-weasyprint)
- AR PL UMing CN font installed for Chinese character rendering (apt-get install fonts-arphic-uming)
Installation
clawhub install tianxingleo/md2pdf-converterRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.