Markdown Presentation Ecosystem
The great experience for creating slide deck
Marp, Markdown Presentation Ecosystem, provides the great experience to create beautiful slide deck. You only have to focus writing your story in Markdown document.
- ---
- theme: gaia
- _class: lead
- paginate: true
- backgroundColor: #fff
- backgroundImage: url('https://marp.app/assets/hero-background.jpg')
- ---
- 
- # **Marp**
- Markdown Presentation Ecosystem
- https://marp.app/
- ---
- # How to write slides
- Split pages by horizontal ruler (`---`). It's very simple! :satisfied:
- ```markdown
- # Slide 1
- foobar
- ---
- # Slide 2
- foobar
- ```
Based on CommonMark
If you know how to write document with Markdown, you already know how to write Marp slide deck too. Our format is based on CommonMark, the consistent spec of Markdown. The only important difference is a ruler --- for splitting pages.
Directives and extended syntax
Nevertheless, you may think the simple text content is lacking to emphasize your voice. We are supporting to create beautiful slide through directives and extended syntax (Image syntax, math typesetting, auto-scaling, etc...).
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 are feeling unsatisfied to design, Marp can tweak style through Markdown, or create your own theme with plain CSS.
Export to HTML, PDF, and PowerPoint
Have you finished writing? Let's share the deck with a favorite way! We can convert Markdown into HTML, what is more, PDF and PowerPoint document directly! (Powered by Google Chrome / Chromium)
Marp family: The official toolset
Marp family has the rich toolset to assist your work. Marp for VS Code extension can preview editting Markdown and custom theme immediately. Marp CLI allows to convert Markdown through CLI interface. Marp Web (Tech demo) can render your deck in online. ...and more!
Pluggable architecture
As a matter of fact, Marp is essentially just a converter for Markdown. Marp ecosystem is built on Marpit framework, the skinny framework for creating HTML + CSS slide deck. It has a pluggable architecture and developer can extend features via plugin.
Fully open-source
We are loving open source! All tools and related libraries by Marp team are MIT license.
Tools and integrations
Marp for VS Code 
Create slide deck written in Marp Markdown on VS Code
Enhance VS Code's Markdown preview pane to support writing your beautiful presentation. You can see the slide deck output as soon as editting Markdown.
For developers
Marpit framework 
The skinny framework for creating slide deck from Markdown
Marpit, independented from Marp, is the skinny framework to transform Markdown + CSS theme to the deck composed of HTML + CSS. It has designed to output only minimum assets.
...and find out all tools, integrations, examples at our GitHub entrance repository!