Marpit Markdown syntax focuses on compatibility with commonly Markdown documents. It means the result of rendering keeps looking nice even if you open the Marpit Markdown in a general Markdown editor.
Marpit splits pages of the slide deck by horizontal ruler (e.g. ---). It's very simple.
# Slide 1
foo
---
# Slide 2
bar?> An empty line may be required before the dash ruler by the spec of CommonMark. You can use the underline ruler ___, asterisk ruler ***, and space-included ruler - - - when you do not want to add empty lines.
Marpit Markdown has extended syntax called "Directives" to support writing awesome slides. It can control your slide-deck theme, page number, header, footer, style, and so on.
Marpit has extended Markdown image syntax  to be helpful creating beautiful slides.
Since v0.9.0, Marpit will parse lists with specific markers as the fragmented list for appearing contents one by one.