Skip to main content

Convert a course to slides

A Storyline course is already slide-shaped, so it maps onto a slide deck more naturally than onto a flat document. Two output formats do this:

  • marp produces Marp-flavored Markdown, which stays editable
  • marp-html produces a self-contained HTML presentation, ready to open

Marp Markdown​

oaf convert my-course.story --format marp

The result is Markdown with slide separators and Marp directives. Edit it, commit it, or run it through the Marp toolchain yourself.

Themes​

oaf convert my-course.story --format marp --marp-theme gaia
Value
defaultMarp's standard theme
gaiaHigher contrast, larger type
uncoverCentered, minimal

Headers, footers, and numbering​

oaf convert my-course.story --format marp \
  --marp-header "Onboarding" \
  --marp-footer "Internal use only" \
  --no-paginate

--marp-header and --marp-footer apply to every slide. --no-paginate removes page numbers, which are on by default.

Marp HTML​

oaf convert my-course.story --format marp-html

This produces an interactive HTML presentation in one file — no build step, no Marp install, just open it.

Presentation or scrolling slides​

oaf convert my-course.story --format marp-html --marp-html-mode slides
ModeBehavior
presentation (default)One slide at a time, navigable
slidesAll slides laid out to scroll through

Use presentation to deliver, slides to review.

Which to choose​

Choose marp when the deck will be edited, reviewed in version control, or restyled. Choose marp-html when someone just needs to open it.

Both accept the content flags from Convert a course to Markdown — --mode, --no-notes, --no-quizzes, --copy-media, and the rest.

Speaker notes are worth keeping for a deck:

oaf convert my-course.story --format marp-html --marp-html-mode presentation

Notes are included by default; --no-notes drops them.