show

A tiny terminal slideshow. Reads markdown, renders it pretty, navigates with vi keys.

Install

just install

Puts show in ~/.local/bin ($XDG_BIN_HOME).

Usage

show              # present ./slides.md
show <path>       # present a file, or <path>/slides.md if it's a directory
show add <name>   # scaffold <name>/slides.md from a template

The intended layout is a slides/ repo with one directory per deck:

slides/
├── claudia-presentation/
│   ├── slides.md
│   └── assets/
└── show-and-tell/
    └── slides.md

Slide format

Slides are separated by --- on its own line.

# First slide

content

---

# Second slide

more content

Cover slide

<!-- cover --> turns a slide into a centered figlet title with subtitle.

<!-- cover -->

# My Talk

a subtitle line

Commentary

A small character can chime in from the bottom-right of any slide:

<!-- say:happy: looking good -->

Available moods: moose, meh, sad, angry, happy, dead. <!-- moosay: ... --> is shorthand for <!-- say:moose: ... -->.

Terminal frames

Code blocks tagged bash, sh, zsh, console, shell, term, or terminal render as a centered terminal window with traffic-light chrome and $ prompts. Other languages keep glamour's syntax highlighting.

```bash
claudia -p work profile init
claudia -p work mount ~/work/repos:rw
```

Raw

<!-- raw --> skips markdown rendering entirely — drop in hand-crafted ASCII art and it'll be centered as-is.

Navigation

Keys	Action
h, j	previous slide
k, l, space	next slide
gg	jump to first
G	jump to last
:N<enter>	jump to slide N
:q<enter>, q	quit