md2pdf-xelatex
by huaruoji
DevOps & CloudBrief
Convert Markdown files to PDF with full LaTeX math formula rendering and CJK (Chinese/Japanese/Korean) support.
Description
What This Skill Does
Converts Markdown files to PDF using Pandoc and XeLaTeX. Handles LaTeX math formulas ($...$ and $$...$$), CJK text (Chinese, Japanese, Korean), code blocks, and tables. Auto-detects CJK content and selects appropriate fonts.
Unlike browser-based Markdown-to-PDF tools, XeLaTeX renders LaTeX math natively and handles CJK fonts without extra configuration or plugins.
When to Use It
- Exporting a research report with equations to PDF
- Converting Chinese-language notes to a printable document
- Generating a PDF from a README with code blocks and tables
- Rendering a math-heavy homework document from Markdown
- Producing a formatted PDF from mixed CJK and Latin text
Example Workflow
User asks: convert my notes.md file (containing Chinese text and math formulas) to a PDF
- 1
Run md2pdf.sh with notes.md as input
- 2
Script scans content and detects CJK characters
- 3
Script selects an available CJK font (e.g., Noto Sans CJK SC)
- 4
Pandoc invokes XeLaTeX to render math and CJK text
- 5
PDF is written to the specified output path
A formatted PDF with rendered LaTeX equations, CJK text, syntax-highlighted code blocks, and a table of contents
Requirements
- pandoc system package
- texlive-xetex system package
- texlive-fonts-recommended system package
- texlive-fonts-extra system package
- texlive-latex-extra system package
- texlive-lang-chinese system package
Installation
clawhub install huaruoji/md2pdf-xelatexRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.