Skip to content

md-slides

Converts a markdown deck (slides separated by `---` HR boundaries or by `# ` H1 headings, with optional `<!-- notes: ... -->` presenter notes blocks) into a single-file HTML presentation with arrow-key / space / PgDn / PgUp / Home / End / P / Esc keyboard navigation, presenter mode (split view with current slide + speaker notes + clock + next-slide preview), URL-hash deep linking, and `@media print` page-per-slide for PDF export. Triggers when the markdown-html-orchestrator classifies an input as SLIDES, or when invoked directly via /cs:md-slides. Reuses md-document's markdown parser for slide-body rendering and reads design-system tokens via config_loader.py. Refuses if input has no clear slide boundaries, produces a 1-slide deck, or `--strict-notes` is on with < 50% notes coverage. Use after orchestrator routing.

Repository Source folder

Details

Path
markdown-html/skills/md-slides
License
MIT
Bundled scripts
3
Dependencies
4

Bundled scripts

  • markdown-html/skills/md-slides/scripts/slide_splitter.py
  • markdown-html/skills/md-slides/scripts/presenter_notes_parser.py
  • markdown-html/skills/md-slides/scripts/deck_html_renderer.py

FAQ