// Export Marp slide markdown files to PDF (default), HTML, PPTX, or PNG. Handles theme loading, Chrome/Chromium detection for PDF export, and batch conversion. Trigger when user says "export slides", "convert marp to pdf", "marp export", "slides to pdf", "slides to html", "导出slides", "slides转pdf", "导出演示文稿".
| name | marp-export |
| description | Export Marp slide markdown files to PDF (default), HTML, PPTX, or PNG. Handles theme loading, Chrome/Chromium detection for PDF export, and batch conversion. Trigger when user says "export slides", "convert marp to pdf", "marp export", "slides to pdf", "slides to html", "导出slides", "slides转pdf", "导出演示文稿". |
| allowed-tools | Read, Bash, Glob, Grep |
Export existing Marp markdown files to PDF (default), HTML, PPTX, or PNG.
# PDF (default) — requires Chrome/Chromium
npx @marp-team/marp-cli INPUT.md -o OUTPUT.pdf --theme-set ~/.claude/skills/marp-slides-creator/themes/ --allow-local-files --html
# HTML
npx @marp-team/marp-cli INPUT.md -o OUTPUT.html --theme-set ~/.claude/skills/marp-slides-creator/themes/ --html
# PPTX (editable, requires LibreOffice)
npx @marp-team/marp-cli INPUT.md -o OUTPUT.pptx --pptx-editable --theme-set ~/.claude/skills/marp-slides-creator/themes/ --allow-local-files
# PNG sequence
npx @marp-team/marp-cli INPUT.md --images png -o OUTPUT_DIR/ --theme-set ~/.claude/skills/marp-slides-creator/themes/
Find the Marp markdown file. It must contain marp: true in YAML frontmatter.
# Verify it's a Marp file
head -5 INPUT.md # should show "marp: true"
Themes are stored in the marp-slides-creator skill:
THEME_DIR="$HOME/.claude/skills/marp-slides-creator/themes/"
Always use --theme-set "$THEME_DIR/" in all export commands.
PDF and PPTX export require a Chrome/Chromium browser. Marp-cli auto-detects, but if it fails:
# macOS Chrome paths (check in order)
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --version
/Applications/Chromium.app/Contents/MacOS/Chromium --version
/Applications/Microsoft\ Edge.app/Contents/MacOS/Microsoft\ Edge --version
# Set CHROME_PATH if auto-detection fails
export CHROME_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
If no browser found, fall back to HTML export and inform the user.
Default format is PDF. User can specify otherwise.
Output naming convention:
presentation.md → presentation.pdfPDF export:
npx @marp-team/marp-cli INPUT.md \
-o OUTPUT.pdf \
--theme-set ~/.claude/skills/marp-slides-creator/themes/ \
--allow-local-files \
--html
HTML export:
npx @marp-team/marp-cli INPUT.md \
-o OUTPUT.html \
--theme-set ~/.claude/skills/marp-slides-creator/themes/ \
--html
Both PDF + HTML:
# Run sequentially
npx @marp-team/marp-cli INPUT.md -o OUTPUT.pdf --theme-set ~/.claude/skills/marp-slides-creator/themes/ --allow-local-files --html
npx @marp-team/marp-cli INPUT.md -o OUTPUT.html --theme-set ~/.claude/skills/marp-slides-creator/themes/ --html
# Check output exists and show file size
ls -lh OUTPUT.pdf OUTPUT.html 2>/dev/null
Report to user:
| Flag | Purpose | When to use |
|---|---|---|
--theme-set DIR/ | Load custom themes | When custom .css themes exist |
--allow-local-files | Allow local images | PDF/PPTX with local assets |
--html | Enable HTML tags in markdown | Always recommended |
--pptx-editable | Editable PPTX output | PPTX format (needs LibreOffice) |
--images png | Export as PNG sequence | PNG format |
--pdf-notes | Include speaker notes in PDF | When notes are present |
--pdf-outlines | Add bookmarks to PDF | For long presentations |
| Error | Cause | Fix |
|---|---|---|
Chrome/Chromium not found | No browser for PDF | Set CHROME_PATH or fall back to HTML |
theme not found | Missing theme CSS | Check --theme-set path, use built-in theme |
Could not find an input | Bad file path | Verify path and marp: true frontmatter |
| Blank/empty PDF | HTML tags without --html | Add --html flag |
# Export current project's slides to PDF
npx @marp-team/marp-cli slides_project/05_final/presentation.md \
-o slides_project/05_final/slides.pdf \
--theme-set ~/.claude/skills/marp-slides-creator/themes/ \
--allow-local-files --html
# Quick HTML export (no Chrome needed)
npx @marp-team/marp-cli my-talk.md -o my-talk.html --html
# Batch export all .md files in a directory
for f in slides/*.md; do
npx @marp-team/marp-cli "$f" -o "${f%.md}.pdf" --allow-local-files --html
done
PROACTIVE SKILL — automatically apply whenever writing, generating, or editing any text that is mainly in Chinese. No user trigger needed. Also use when the user explicitly asks to "fix Chinese", "修改中文", "去翻译腔", "去AI味", "fix Chinese formatting", or "review Chinese text". Eliminates AI-sounding expressions and translation artifacts. Enforces Chinese-English mixed formatting rules (spacing, punctuation, bold formatting).
Convert Markdown files to Word documents (.docx) with proper formatting, Chinese font support (FangSong for all text including headings), black font color, 1.5x line spacing, precise first-line indent (24pt), heading spacing after (1 line), no italic headings, and automatic superscript conversion for citation numbers. Use when converting .md files to .docx, creating Word documents from markdown, or when user mentions Word, DOCX, or document conversion. Requires pandoc.
专业Marp演示文稿制作助手。支持完整工作流程：工作空间初始化、内容分析、slides制作、多维度审阅、中文语言规范审阅（中文演示文稿）、PNG转换检查、终稿确定。所有产出物集中管理在项目工作文件夹中。当用户提到"制作slides"、"做PPT"、"演示文稿"、"Marp"、"幻灯片"、"presentation"等关键词时自动启用。Professional Marp presentation assistant with complete workflow: workspace initialization, content analysis, slide creation, multi-dimensional review, Chinese language review (for Chinese presentations), PNG conversion check, and finalization. All outputs organized in project workspace.
This skill should be used when the user asks to "/do-agent", asks for "Execute complex tasks using multi-agent architecture with context protection", or needs the workflow previously provided by the /do-agent slash command.
This skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", or needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in commands, user interaction patterns, or command development best practices for Claude Code.