Marp - Markdown Presentation Writer

Important: Upgrade to v0.0.11

Marp v0.0.10 or earlier have a vulnerability: Remote script can read any local resource without intent of user. We have patched this problem on v0.0.11.

We recommend to upgrade to Marp v0.0.11 strongly. Please download the latest version from above and overwrite your Marp!!

v0.0.11 release note More details at GitHub issue JVN#21174546 (English) JVN#21174546 (Japanese)


Marp is the simplest presentation writer with Markdown.

  • Create slides with Markdown
  • Cross-platform
  • Live preview with 3 modes
  • Theme supports (Default & Gaia theme)
  • Supports rendering emoji, math, and background image.
  • Export slides as PDF!

Marp is powered by Electron.

Writing by Marp

How to write slides?

The text format is based on GitHub Flavored Markdown.

Marp uses the horizontal ruler to create multi-page slides. A --- between empty lines splits the presentation into slides. This format is similar to Deckset.


# Slide 1



# Slide 2



Marp’s Markdown has extended directives to affect slides. Insert HTML comment as <!-- {directive_name}: {value} -->


You want pagination? Insert <!-- page_number: true --> at the top.

If you want to exclude the first page number, move the directive to after the first ruler.

# First page

The page number `1` is not shown.

<!-- page_number: true -->

# Second page

The page number `2` is shown!

Resize slide

You can resize slides with the Global Directive $size. Insert <!-- $size: 16:9 --> if you want to display slides on 16:9 screen. That’s all!

<!-- $size: 16:9 -->

$size directive supports 4:3, 16:9, A0-A8, B0-B8 and the -portrait suffix.

Marp also supports $width and $height directives to set a custom size.

You want an example? Have a look at


Copyright © 2016 Yuki Hattori.
This software released under the MIT License.