SkillAgentSearch skills...

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-export

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

91/100

Supported Platforms

Universal

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.

Substance
26/30
Structure
20/20
Description
15/15
Adoption
15/20
Freshness
15/15

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 found

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.

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.

SkillScoreStarsUpdatedFormat
marp-export (this skill)by brycewang-stanford914.4k54d agoSKILL.md
siyuanby siyuan-note10047.3ktodayMCP Server
x402by browser-use100121.0k3d agoSKILL.md
algorithmic-artby anthropics100177.9k55d agoSKILL.md
pptxby anthropics100177.9k55d agoSKILL.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.

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

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

View on GitHub
GitHub Stars4.4k
CategoryContent
Updated1mo ago
Forks527

Languages

Stata

Trust signals

88/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium