gitwtfhub

wtf is marp?

marp-team/marp — explained in plain English

Analysis updated 2026-06-24

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

TL;DR

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

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

Why would anyone build with this?

REASON 1

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

REASON 2

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

REASON 3

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

REASON 4

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

What's in the stack?

TypeScriptMarkdownNode.js

How it stacks up

marp-team/marpportkey-ai/gatewayquipnetwork/ethereum-sdk
Stars11,71111,71011,694
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasyhard
Complexity2/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Wtf does this do

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.

Yoink these 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?

Frequently asked questions

wtf is marp?

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.

What language is marp written in?

Mainly TypeScript. The stack also includes TypeScript, Markdown, Node.js.

How hard is marp to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is marp for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.