Marp
An entry point to the Marp family of tools for making slide decks from plain Markdown.
- Stars
- 12.7k
- Forks
- 304
- Licence
- MIT
- Language
- TypeScript
- Last update
- 3 months ago
- Type
- Other
What it is
Marp is a set of open-source projects for writing presentations in plain Markdown text and converting them into slides. This repository is mainly a hub that links to the family's parts: the Marpit framework, Marp Core, Marp CLI for exporting to HTML, PDF, PPTX or images, and a VS Code extension for previewing decks. The README also links to the project website and an awesome list of Marp resources.
- Write a slide deck in a .md file and export it to PDF or PPTX with Marp CLI
- Preview slides live while editing in VS Code with the Marp extension
- Use the built-in themes from Marp Core for consistent slide styling
- Browse community resources through the linked awesome-marp list
Great for
- People who prefer writing slides as Markdown text rather than in a visual editor
- Developers who want to generate slide decks from code or scripts
- VS Code users who want a live preview of their slides
- Anyone looking for an overview of the Marp ecosystem before choosing a component
Not ideal for
- Users who need a drag-and-drop slide editor, since this project is text-based (reason: the README describes Markdown writing, not a visual editor)
- People who need the classic Marp app, which the README says is archived (reason: the README points to a gravesite for the old app)
How to get it
- 1
See the README
Clone this repository
git clone https://github.com/marp-team/marp - 2
Run it
- Open the Marp website at https://marp.app to see the project overview
- Pick a component from the list, such as Marp CLI for command-line export or Marp for VS Code for editing
- Follow the installation instructions in that component's own repository
- Create a Markdown file and start writing slides in it
- 3
Get the most out of it
- Use Marp CLI to convert decks into HTML, PDF, PPTX or image formats
- Install the VS Code extension for a live preview while you write
- Explore Marp Core's built-in themes for styling options
- Check the awesome-marp list for community tools and examples
- Join the discussion forum for questions and ideas
Downloads
Strengths
- Slides are plain Markdown files that work with version control and any text editor
- Multiple export formats are supported through the CLI, according to the README
- Released under the MIT license with an active project and a large community
Trade-offs
- This repository is a directory of links, so you must install the individual components to actually make slides
- The README does not give installation commands for the components, so setup details must come from their own repos
- Some older parts such as Marp Web, Marp React and Marp Vue are listed as outdated or inactive
How it compares
| Project | Stars | Type | Level | Updated | Best for |
|---|---|---|---|---|---|
| marp (this) | 12.7k | Other | beginner | 3 months ago | People who prefer writing slides as Markdown text rather than in a visual editor |
| reveal.js | 72.5k | Library | intermediate | 1 months ago | Developers who already write HTML, CSS, or JavaScript and want full control over slide design |
| slidev | 49.3k | Dev tool | beginner | 14 days ago | Developers who want to present code, technical talks, or architecture diagrams |
| mdx-deck | 11.5k | Dev tool | intermediate | 3.8 years ago | Developers who already write React and want to present technical material |
| slides | 11.7k | App | beginner | 4 months ago | Developers who already live in the terminal and want to present technical material |
| nodeppt | 10.3k | Dev tool | intermediate | 5.8 years ago | Developers who prefer writing slides in Markdown over a visual editor |
Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.