Marp:Markdown Presentation Ecosystem
Create beautiful slide decks using an intuitive Markdown experience
Marp (also known as the Markdown Presentation Ecosystem) provides an intuitive experience for creating beautiful slide decks. You only have to focus on writing your story in a Markdown document.
Based on CommonMark
If you know how to write a document with Markdown, you already know how to write a Marp slide deck. Marp's format is based on CommonMark, a consistent Markdown specification. The only important difference is a ruler ---
for splitting pages.
Directives and extended syntax
Sometimes simple text content isn't enough to emphasize your voice, so Marp supports a variety of directives and extended syntax (image syntax, math typesetting, auto-scaling, etc...) to create beautiful slides.
Built-in themes and CSS theming
Our core engine has 3 built-in themes called default
, gaia
, and uncover
, to tell your story beautifully. If you'd rather customize your design, you can use Marp to tweak styles with Markdown, or create your own Marp theme with plain CSS.
Export to HTML, PDF, and PowerPoint
Have you finished writing? It's time to share your deck! Marp can convert Markdown into presentation-ready HTML, PDF and PowerPoint files directly! (Powered by Google Chrome / Chromium)
Marp family: The official toolset
The Marp ecosystem contains a rich toolset to assist your work. Marp for VS Code is an extension that allows you to edit and preview slide Markdown and custom theming within VS Code. Marp CLI is a command line tool allows you to convert Markdown with a simple CLI interface. ... and much more!
Pluggable architecture
As a matter of fact, Marp is essentially just a converter for Markdown. The Marp ecosystem is built on the Marpit framework, a skinny framework for creating HTML/CSS slide decks. It has a pluggable architecture and any developer can extend features via plugins.
Fully open-source
The Marp team loves open source! All tools and related libraries are built by the Marp team and are MIT-licensed.
Tools and integrations
Marp for VS Code
Create slide decks written in Marp Markdown right in VS Code
Enhance VS Code's Markdown preview pane to support writing your beautiful presentations. You can preview the slide deck output as soon as you edit its Markdown.
Marp CLI
A CLI interface for Marp and Marpit based converters
The Marp CLI is the swiss army knife of the Marp ecosystem. Convert your Markdown into various formats, watch changes, launch server for on-demand conversion, and customize the core engine.
For developers
Marp Core
The core of the Marp converter
All official Marp tooling uses this core as the engine. It is based on the Marpit framework and includes some extra features to help create beautiful slide decks.
Marpit framework
The skinny framework for creating slide decks from Markdown
Marpit (independented from Marp) is the framework that transforms Markdown and CSS themes to slide decks composed of HTML/CSS. It is optimized to output only the minimum set of assets required.
Find all of the Marp tools, integrations, and examples in the GitHub repository!