Autocue speaker notes using Markdown

So I seem to have written a markdown-teleprompter-slideshow thing to scratch a personal itch.

This is for 'speaker notes' type scripts rather than verbatim scrolling autocue. Gojko Adzic has a lovely browser tool for that.

• H2 headings (##) separate slides
• Active bullet highlighted, the rest dim
  • Sub-bullets highlighted a different colour
• Keeps current bullet in centre of viewport ('typewriter mode') so you aren't looking up and down the screen
• Uses Marp, so arrow keys, home/end, clicker all do what you would expect
• Live update: edit the markdown, view hot-reloads
• Theme-able, everything except scroll-centring is CSS

Usage

Put the following frontmatter in your Markdown file:

---
marp: true
---

Then run marp-cue from the directory like so:

% npx marp-cue your-notes.md # or npx marp-cue .

This will open a stripped-down browser window ('preview mode') for your file, or for every Markdown file in the directory that has marp: true. You can place this window in your teleprompter screen and the current line will stay vertically aligned in the middle of the viewport.

Marp watches the file(s), so as soon as you save any changes, they show instantly without a refresh.

You can just generate the HTML file to run elsewhere by passing --preview false, which disables preview mode.