Repolode
Submit
marp-team

marp-team/marp-cli

A command-line tool that converts Marp and Marpit Markdown slide decks into HTML, PDF, PPTX, and PNG/JPEG images.

Open-source alternative to:PowerPointKeynote

View on GitHub
Stars
3,909
Forks
204
Open issues
20
Last commit
2 months ago

What is it?

Marp CLI is the command-line interface for Marp and other converters built on the Marpit framework. It turns Markdown files written in Marp syntax into static HTML and CSS, PDF, PowerPoint (PPTX), and PNG or JPEG images. Conversions to PDF, PPTX, and images use a locally installed Chrome, Edge, or Firefox browser.

Beyond one-off conversion, it offers a watch mode that rebuilds on file changes and refreshes the open page, a server mode that converts decks on demand over HTTP, and a preview window for presenting. Output can include presenter notes, PDF outlines, and metadata such as title, author, and Open Graph image. Themes can be overridden or supplied as custom CSS.

Marp CLI can be run with npx, installed locally or globally through npm, used via Docker, or downloaded as a standalone binary. It also provides a Node.js API and a configuration file (marp.config.js, .marprc, or the package.json marp section) for project-wide settings.

Key features

  • 01Converts Markdown slides to HTML, PDF, PPTX, and PNG/JPEG images.
  • 02Watch mode rebuilds on changes and auto-refreshes the browser.
  • 03Server mode serves decks and converts them on demand via query strings.
  • 04Preview window and bespoke HTML template with keyboard navigation.
  • 05Supports presenter notes export and PDF outlines.
  • 06Configurable through CLI flags, config files, or a Node.js API.

Use cases

  • Writing technical talks in Markdown and exporting PDF handouts.
  • Generating PowerPoint files from Markdown for colleagues who use Office.
  • Automating slide builds in CI or a documentation pipeline with Docker.
  • Creating Open Graph images from a deck's title slide.

Quick start

  1. 1

    Install Node.js v18 or later

  2. 2

    Convert a slide deck to HTML with npx

    npx @marp-team/marp-cli@latest slide-deck.md
  3. 3

    Convert a slide deck to PDF (requires Chrome, Edge, or Firefox)

    npx @marp-team/marp-cli@latest slide-deck.md --pdf

Things to know

  • PDF, PPTX and image conversion require Google Chrome, Microsoft Edge, or Mozilla Firefox to be installed.
  • The experimental --pptx-editable option also requires LibreOffice Impress and gives lower slide reproducibility.

In collections

CLI & terminal toolsPDF, OCR & document toolsStatic site generators & documentation tools

Topics

#markdown#presentation#slides#pdf#pptx#cli#marp#deck#marpit

FAQ

What is marp-cli?
A command-line tool that converts Marp and Marpit Markdown slide decks into HTML, PDF, PPTX, and PNG/JPEG images. Marp CLI is the command-line interface for Marp and other converters built on the Marpit framework. It turns Markdown files written in Marp syntax into static HTML and CSS, PDF, PowerPoint (PPTX), and PNG or JPEG images. Conversions to PDF, PPTX, and images use a locally installed Chrome, Edge, or Firefox browser.
Is marp-cli free to use? What license does it have?
marp-cli is open source under the MIT license. Check the license terms before using it in commercial products.
Is marp-cli still maintained?
Updated within 6 months. The last commit to marp-cli was on Sep 8, 2026.
What can I use marp-cli for?
Writing technical talks in Markdown and exporting PDF handouts. Generating PowerPoint files from Markdown for colleagues who use Office. Automating slide builds in CI or a documentation pipeline with Docker. Creating Open Graph images from a deck's title slide.
How do I install marp-cli?
Install Node.js v18 or later Convert a slide deck to HTML with npx: npx @marp-team/marp-cli@latest slide-deck.md Convert a slide deck to PDF (requires Chrome, Edge, or Firefox): npx @marp-team/marp-cli@latest slide-deck.md --pdf
Where can I get marp-cli?
The source code and installation instructions are on GitHub: https://github.com/marp-team/marp-cli

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects