whatisgithub

What is marp?

marp-team/marp — explained in plain English

Analysis updated 2026-06-24

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

In one sentence

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

What do people build with it?

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.

What is it built with?

TypeScriptMarkdownNode.js

How does it compare?

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 get it running?

Difficulty · easy Time to first run · 5min

So what is it?

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?

Frequently asked questions

What 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.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.