explaingit

marp-team/marp

11,711TypeScriptAudience · developerComplexity · 2/5Setup · easy

TLDR

Marp converts plain-text Markdown files into polished presentation slides, with a CLI for exporting to HTML, PDF, and PowerPoint and a VS Code extension that shows a live preview as you type.

Mindmap

mindmap
  root((marp))
    What it does
      Markdown to slides
      Multiple export formats
      Live preview
    Export formats
      HTML
      PDF
      PowerPoint
      Images
    Tools
      Marp CLI
      VS Code extension
      Core converter
    Themes
      Built-in themes
      Custom themes
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Write presentation slides in plain-text Markdown and export them to PDF or PowerPoint with a single command.

USE CASE 2

Use the VS Code extension to see a live slide preview update as you type your Markdown.

USE CASE 3

Export slide decks to HTML for publishing online without needing a dedicated presentation tool.

USE CASE 4

Apply built-in Marp themes to give your slides a polished look without writing CSS.

Tech stack

TypeScriptMarkdownNode.js

Getting it running

Difficulty · easy Time to first run · 5min

In plain English

Marp is a collection of tools for creating presentation slides by writing plain text in Markdown format. Markdown is a simple way of formatting text using characters like asterisks and hash symbols, and Marp takes documents written that way and converts them into polished slide decks. The ecosystem is split across several focused pieces. The core converter handles turning Markdown into slides and comes with a set of built-in visual themes. A command-line tool called Marp CLI lets you export your slides to HTML, PDF, PowerPoint format, or image files. For people who write code in the VS Code editor, there is an extension that shows a live preview of the slides as you type. This particular repository is the front door to the Marp family rather than a single application. The actual slide-making logic lives in separate repositories that handle specific parts of the process, and this repo hosts the project website and serves as the central discussion point for the ecosystem as a whole. Marp is aimed at developers and technical writers who already work with plain text and want to produce presentations without switching to a dedicated slide tool. You write in a text file, run the converter, and get a formatted presentation out. The project is open source and maintained by a small team, with community sponsorship available through GitHub Sponsors.

Copy-paste prompts

Prompt 1
I have a Markdown file with content I want to turn into slides. Show me how to use Marp CLI to export it to PDF.
Prompt 2
How do I set up the Marp VS Code extension to preview my Markdown presentation live as I write it?
Prompt 3
How do I export a Marp Markdown presentation to PowerPoint format using the CLI?
Prompt 4
I want to apply a specific built-in Marp theme to my slides. Where do I add the theme setting in my Markdown file?
Prompt 5
How do I separate individual slides in a Marp Markdown file?
Open on GitHub → Explain another repo

← marp-team on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.