Marp

Fragmented list

Marp uses some uncommon list markers to denote a fragmented list (also known as an incremental list or builds), which allows list content to appear incrementally.

Fragmented lists are only available if you export to HTML. If you export to PDF and PPTX, the fragmented list will be rendered as a normal list.

Be careful when using fragmented lists. While fragmented lists can help focus the audience's attention on the last displayed item, they may also create confusion about hidden items. Some articles recommend never using builds (e.g. Presentation Rules).

For bullet lists

CommonMark's bullet list markers are -, +, and * (https://spec.commonmark.org/0.29/#bullet-list-marker). If you use * as the marker, Marp will parse the list as a fragmented list.

  1. # Bullet list

  3. - One
  4. - Two
  5. - Three

  7. ---

  9. # Fragmented list

  11. * One
  12. * Two
  13. * Three

For ordered list

CommonMark's ordered list marker must have . or ) after digits. If you use ) as the following character, then Marp will parse the ordered list as a fragmented list.

  1. # Ordered list

  3. 1. One
  4. 2. Two
  5. 3. Three

  7. ---

  9. # Fragmented list

  11. 1) One
  12. 2) Two
  13. 3) Three

These are inherited from Marpit framework.

This syntax only indicates that the list should be fragmented. If the tools integrated with Marp do nothing with the syntax, this list would be rendered as a normal list. In the official toolset, Marp CLI's default HTML template bespoke can reproduce a fragmented list as a build animation.