Marp Export Skill

Export existing Marp markdown files to PDF (default), HTML, PPTX, or PNG.

⚠️ Two silent failure modes (read first)

1. Wrong theme dir → silent fallback. If the theme named in the file's theme: frontmatter is not in the --theme-set dir, marp-cli does NOT error — it silently renders with the default theme (brand colors, headers, footers all gone). Always resolve the theme dir from the frontmatter theme name (Step 2).
2. Sandboxed PDF/PPTX export → CJK glyphs lost. When the Bash tool runs sandboxed, Chrome's printToPDF cannot access system CJK fonts: the PDF exports "successfully" but all Chinese/Japanese/Korean text is missing (only ASCII remains; file size drops sharply). Run PDF and PPTX exports with dangerouslyDisableSandbox: true. HTML and PNG exports are unaffected.

Both failures are invisible in logs — they only show up when you render the produced PDF itself (Step 5).

Quick Reference

# Resolve THEME_DIR first (Step 2), then:

# PDF (default) — requires Chrome/Chromium; run UNSANDBOXED
npx @marp-team/marp-cli INPUT.md -o OUTPUT.pdf --theme-set "$THEME_DIR" --allow-local-files --html