Marp Cli

Convert Markdown to presentations via CLI. Output HTML, PDF, PowerPoint (PPTX), and images (PNG/JPEG).

Security Scan

The skill is an instruction-only wrapper for the Marp CLI and its requirements/instructions are consistent with converting Markdown to presentations.

Purpose & Capability

Name/description (Markdown→presentations) aligns with the declared requirement (needs the 'marp' binary) and the SKILL.md commands. No unrelated credentials, binaries, or config paths are requested.

Instruction Scope

SKILL.md only instructs running marp CLI commands and documents options (watch, server, --allow-local-files, --browser-path). Those options legitimately expand Marp's capabilities (e.g., server exposes files, --allow-local-files permits local file access). This is expected for a CLI reference but is a user-risk consideration rather than an incoherence.

Install Mechanism

No install spec and no code files — lowest-risk, instruction-only skill. The README suggests standard installation methods (npm, brew, binaries) which are appropriate.

Credentials

No environment variables or credentials are required by the skill. Examples show use of PORT/HOST and --browser-path, which are normal usage patterns and not unexpected secret requests.

Persistence & Privilege

Skill is not always-enabled, does not request persistent privileges, and contains no install-time actions. Autonomous invocation is allowed (platform default) but the skill has no extra persistent access.

Assessment

This skill is a documentation-only wrapper around the Marp CLI — it assumes you already have a legitimate 'marp' binary. Before using: (1) install marp from the official project (npm, Homebrew, or official releases) to avoid malicious binaries; (2) be cautious with server mode and --allow-local-files (they can expose local files or loads of data if served to networks); (3) avoid feeding untrusted Markdown that may reference local resources if you enable local-file access; and (4) ensure your browser executable path is explicit if you have multiple browsers to avoid accidentally invoking an unexpected binary.

Convert Markdown to presentations via CLI. Output HTML, PDF, PowerPoint (PPTX), and images (PNG/JPEG).

Browser requirement: Conversions marked with 🌐 require a compatible browser (Chrome, Edge, or Firefox) installed on your system.

Quick Start

# Convert to HTML
marp slide-deck.md

# Convert to PDF (requires browser)
marp --pdf slide-deck.md

# Convert to PowerPoint
marp --pptx slide-deck.md

# Convert to images
marp --images png slide-deck.md

📖 Detailed guide: QUICKSTART.md

Format conversion

HTML

marp slide-deck.md
marp slide-deck.md -o output.html

PDF 🌐

marp --pdf slide-deck.md
marp slide-deck.md -o output.pdf

# With PDF outlines
marp --pdf --pdf-outlines slide-deck.md

# Includes presenter notes as annotations on lower-left
marp --pdf --pdf-notes slide-deck.md

PowerPoint (PPTX) 🌐

marp --pptx slide-deck.md
marp slide-deck.md -o output.pptx

# Editable PPTX (experimental, requires LibreOffice Impress)
marp --pptx --pptx-editable slide-deck.md

Images 🌐

# Multiple images
marp --images png slide-deck.md
marp --images jpeg slide-deck.md

# Title slide image only
marp --image png slide-deck.md
marp slide-deck.md -o output.png

# High resolution (scale factor)
marp slide-deck.md -o title.png --image-scale 2

Presenter notes

marp --notes slide-deck.md
marp slide-deck.md -o output.txt

Watch mode

# Watch file and auto-convert on changes
marp -w slide-deck.md

# Watch with browser preview
marp -w -p slide-deck.md

Server mode

# Serve directory with on-demand conversion
marp -s ./slides

# Specify port via environment
PORT=5000 marp -s ./slides

# Access converted formats via query strings
# http://localhost:8080/deck.md?pdf
# http://localhost:8080/deck.md?pptx

Preview window

# Open preview window (automatically enables watch mode)
marp -p slide-deck.md

# Preview with PDF output
marp -p --pdf slide-deck.md

Multiple files

# Convert multiple files
marp slide1.md slide2.md slide3.md

# Convert directory
marp ./slides/

# Use glob patterns
marp **/*.md

# Convert with parallelism (default: 5 concurrent)
marp -P 10 ./*.md

# Disable parallelism
marp --no-parallel ./*.md

Options

Option	Description
-o, --output <path>	Output file path
-w, --watch	Watch mode - auto-convert on changes
-s, --server <dir>	Server mode - serve directory
-p, --preview	Open preview window
--pdf	Convert to PDF (requires Chrome/Edge/Firefox)
--pptx	Convert to PowerPoint PPTX (requires browser)
--pptx-editable	Generate editable PPTX (experimental)
--images [png|jpeg]	Convert to multiple images
--image	Convert title slide to single image
--image-scale <factor>	Scale factor for images
--notes	Export presenter notes to TXT
--pdf-notes	Add PDF note annotations
--pdf-outlines	Add PDF outlines/bookmarks
--allow-local-files	Allow accessing local files (security note)
--browser <chrome|edge|firefox>	Choose browser for conversion
--browser-path <path>	Specify browser executable path
-P, --parallel <num>	Parallel conversion count
--no-parallel	Disable parallel conversion
--template <name>	HTML template (default: bespoke)

Common patterns

# Watch and preview while editing
marp -w -p deck.md

# Serve slides directory
marp -s ./presentations

# Convert all slides to PDF
marp --pdf *.md

# Create OG image from title
marp deck.md -o og.png --image-scale 3

# Export presenter notes
marp --notes deck.md

Documentation

Document	Description
QUICKSTART.md	Quick start guide
EXAMPLES.md	Detailed examples
README.md	Project overview
Official docs	https://github.com/marp-team/marp-cli