marp-export
Export Marp slide markdown files to PDF (default), HTML, PPTX, or PNG. Handles theme loading, Chrome/Chromium detection for PDF export, and batch conversion.
Install / Use
npx skills add brycewang-stanford/Auto-Empirical-Research-Skills --skill marp-exportInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Content & MediaSupported Platforms
Our assessment of marp-export
marp-export scores 91/100 on our quality scale, 348th of 1,155 Content & Media skills we index (top 31%).
Its SKILL.md is 4.6 KB long, well organised into 23 sections with 9 code examples: a solid amount of guidance for an agent.
With 4,360 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so marp-export is actively maintained.
- Our last check on 2026-10-28 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
marp-export compared with similar skills
All 4 of these similar skills score higher than marp-export; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| marp-export (this skill)by brycewang-stanford | 91 | 4.4k | 54d ago | SKILL.md |
| siyuanby siyuan-note | 100 | 47.3k | today | MCP Server |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
Frequently asked questions
- How do I install marp-export?
- Run
npx skills add brycewang-stanford/Auto-Empirical-Research-Skills --skill marp-export. The install tabs above show the steps for each supported agent. - Which AI agents does marp-export work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is marp-export safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is marp-export still maintained?
- The repository was last updated about 2 months ago, so marp-export is actively maintained.
Skill content
View source on GitHubname: 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
Marp Export Skill
Export existing Marp markdown files to PDF (default), HTML, PPTX, or PNG.
Quick Reference
# 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/
Workflow
Step 1: Locate Input File
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"
Step 2: Theme Directory
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.
Step 3: Detect Chrome/Chromium (for PDF/PPTX)
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.
Step 4: Export
Default format is PDF. User can specify otherwise.
Output naming convention:
- Same directory as input file
- Same base name, different extension
- Example:
presentation.md→presentation.pdf
PDF 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
Step 5: Verify & Report
# Check output exists and show file size
ls -lh OUTPUT.pdf OUTPUT.html 2>/dev/null
Report to user:
- Output file path(s)
- File size(s)
- Format(s) generated
- Any warnings from marp-cli
Key Flags Reference
| 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 Handling
| 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 |
Examples
# 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
Related Skills
siyuan
47.3kAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
