git404hub

what is peitho fr?

mizzy/peitho — explained in plain English

Analysis updated 2026-05-18

19RustAudience · developerSetup · easy

tl;dr

A tool that turns Markdown text files into slide presentations, keeping content and visual design completely separate.

vibe map

mindmap
  root((peitho))
    What it does
      Markdown to slides
      Separates content and design
      Type checked layouts
    Tech stack
      Rust
      Homebrew install
      Cargo install
    Use cases
      Conference talks
      Reusable themes
      PDF export
    Audience
      Developers
      Technical speakers
    Workflow
      Live preview
      Presenter view
      Phone remote

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Write a conference talk or team presentation entirely in Markdown instead of a slide editor.

VIBE 2

Reuse one visual design across many decks by keeping layout HTML and CSS separate from content.

VIBE 3

Present with a laptop and phone as a remote control, with speaker notes and a timer visible only to the presenter.

VIBE 4

Export a finished deck as a PDF or publish it straight to a hosting destination.

what's the stack?

Rust

how it stacks up fr

mizzy/peithod10n/tui-globehase9awa/termtypist
Stars191919
LanguageRustRustRust
Setup difficultyeasyeasymoderate
Complexity3/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 30min

in plain english

Peitho is a tool for building slide presentations, but instead of dragging boxes around in PowerPoint or Keynote, you write your slides in plain Markdown text. The name comes from the Greek goddess associated with persuasion through words, which fits since the whole idea is to let your words carry the presentation instead of fussing over visual design each time. The core idea is a strict separation between content and design. Your slide text lives in a Markdown file, while the visual layout and styling live in separate HTML and CSS files that you keep in version control alongside your content. Because layouts are reusable, once you set one up you never have to think about design again for future decks, you just write. Each layout defines named slots, like a title slot or a body slot, and Peitho checks every slide against those slots when it builds the deck. If a slide has content that does not fit the layout, such as an extra code block where only one is allowed, the build stops and tells you exactly where the problem is rather than silently dropping content. Writing a deck is simple: slides are separated by three dashes, the heading becomes the title, code blocks flow into a code slot, and everything else becomes body text. You can add per-slide settings and speaker notes using special comments in the Markdown file. Peitho also includes tools for the whole workflow: a live preview that rebuilds and refreshes your browser as you edit, a presentation mode that puts slides on an external screen while showing you speaker notes and a timer on your own machine, the option to use your phone as a remote control, and commands to export a deck as a PDF or publish it to a hosting destination of your choice. It is written in Rust and installable via Homebrew or Cargo, and comes with a documentation site with guides and example decks.

prompts (copy fr)

prompt 1
Help me install peitho and scaffold my first Markdown slide deck.
prompt 2
Show me how to write a two-column slide layout using peitho's explicit slot syntax.
prompt 3
Explain how to set up per-slide speaker notes and a timed agenda in peitho.
prompt 4
Walk me through using peitho present --host to control my slides from my phone.
prompt 5
Help me write a custom peitho layout with a title slot and an image slot.

Frequently asked questions

what is peitho fr?

A tool that turns Markdown text files into slide presentations, keeping content and visual design completely separate.

What language is peitho written in?

Mainly Rust. The stack also includes Rust.

How hard is peitho to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is peitho for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.