How do I install the Md2pdf skill?

Run npx skillmds@latest add modbender/md2pdf-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Md2pdf safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Md2pdf?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Md2pdf free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Md2pdf?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Md2pdf by modbender — Agent Skill

Name: Md2pdf
Rating: 4.2 (5 reviews)
Author: modbender

Md2pdf

Convert Markdown files to PDF with full LaTeX math formula rendering and CJK (Chinese/Japanese/Korean) support. Use when the user asks to convert markdown to PDF, render a report as PDF, export notes to PDF, or generate a printable document from markdown. Handles $...$ inline and $$...$$ display math, code blocks, tables, and mixed CJK/Latin text. Requires pandoc + texlive-xetex.

modbender Updated Sep 22, 2026 12 repo stars

File contents

md2pdf

Convert Markdown → PDF via Pandoc + XeLaTeX. Full LaTeX math + CJK support.

Prerequisites

System packages (apt):

pandoc texlive-xetex texlive-fonts-recommended texlive-fonts-extra texlive-latex-extra texlive-lang-chinese

Quick Convert

bash <skill_dir>/scripts/md2pdf.sh input.md output.pdf

The script auto-detects CJK content, picks suitable fonts, sanitizes emoji, adds TOC, and configures XeLaTeX.

Manual Pandoc Command

For fine-grained control, run pandoc directly:

pandoc input.md -o output.pdf \
  --pdf-engine=xelatex \
  -f markdown-smart \
  -H header.tex \
  -V mainfont="DejaVu Sans" \
  -V monofont="DejaVu Sans Mono" \
  -V geometry:margin=20mm \
  -V fontsize=10pt \
  -V colorlinks=true \
  --highlight-style=tango \
  --toc -V toc-title="Table of Contents"

Where header.tex contains:

\usepackage{xeCJK}
\setCJKmainfont{<CJK font name>}

Key Details

Math: Pandoc natively converts $...$ (inline) and $$...$$ (display) to LaTeX math. No MathJax/KaTeX needed.
CJK fonts: Script auto-detects from: Noto Sans CJK SC > WenQuanYi Micro Hei > Droid Sans Fallback > AR PL UMing CN.
Emoji: Replaced with text equivalents (✅ → [Y], ❌ → [N], ⭐ → *) since most LaTeX fonts lack emoji glyphs.
Smart quotes: Use -f markdown-smart to avoid curly quote rendering issues.
Long tables: Pandoc may struggle with complex tables; keep tables simple or use longtable LaTeX package.

Troubleshooting

Problem	Fix
Missing character warnings	Check `fc-list :lang=zh` for available CJK fonts; install `fonts-noto-cjk` if needed
`xelatex not found`	Install `texlive-xetex`
PDF has no math rendering	Ensure markdown uses $...$ / `$$...$$` (not HTML math tags)
Broken table layout	Simplify table or add `-V geometry:margin=15mm` for more width

---name: md2pdf-2description: Convert Markdown files to PDF with full LaTeX math formula rendering and CJK (Chinese/Japanese/Korean) support. Use when the user asks to convert markdown to PDF, render a report as PDF, export notes to PDF, or generate a printable document from markdown. Handles $...$ inline and $$...$$ display math, code blocks, tables, and mixed CJK/Latin text. Requires pandoc + texlive-xetex.---# md2pdfConvert Markdown → PDF via Pandoc + XeLaTeX. Full LaTeX math + CJK support.## PrerequisitesSystem packages (apt):```pandoc texlive-xetex texlive-fonts-recommended texlive-fonts-extra texlive-latex-extra texlive-lang-chinese```## Quick Convert```bashbash <skill_dir>/scripts/md2pdf.sh input.md output.pdf```The script auto-detects CJK content, picks suitable fonts, sanitizes emoji, adds TOC, and configures XeLaTeX.## Manual Pandoc CommandFor fine-grained control, run pandoc directly:```bashpandoc input.md -o output.pdf \ --pdf-engine=xelatex \ -f markdown-smart \ -H header.tex \ -V mainfont="DejaVu Sans" \ -V monofont="DejaVu Sans Mono" \ -V geometry:margin=20mm \ -V fontsize=10pt \ -V colorlinks=true \ --highlight-style=tango \ --toc -V toc-title="Table of Contents"```Where `header.tex` contains:```latex\usepackage{xeCJK}\setCJKmainfont{<CJK font name>}```## Key Details- **Math**: Pandoc natively converts `$...$` (inline) and `$$...$$` (display) to LaTeX math. No MathJax/KaTeX needed.- **CJK fonts**: Script auto-detects from: Noto Sans CJK SC > WenQuanYi Micro Hei > Droid Sans Fallback > AR PL UMing CN.- **Emoji**: Replaced with text equivalents (`✅` → `[Y]`, `❌` → `[N]`, `⭐` → `*`) since most LaTeX fonts lack emoji glyphs.- **Smart quotes**: Use `-f markdown-smart` to avoid curly quote rendering issues.- **Long tables**: Pandoc may struggle with complex tables; keep tables simple or use `longtable` LaTeX package.## Troubleshooting| Problem | Fix ||---------|-----|| Missing character warnings | Check `fc-list :lang=zh` for available CJK fonts; install `fonts-noto-cjk` if needed || `xelatex not found` | Install `texlive-xetex` || PDF has no math rendering | Ensure markdown uses `$...$` / `$$...$$` (not HTML math tags) || Broken table layout | Simplify table or add `-V geometry:margin=15mm` for more width |

Frequently asked questions