Skip to content

SliDesk

logo

Markdown-first slides with native internationalisation and file includes — no Vue project, no build step, no plugin hunting.

See the live demo → (also in French, from the same source)

SliDesk is a talk engine that turns Markdown into web-based presentations. If you want the simplicity of Marp with the capabilities of Slidev, but without maintaining a Vue/Vite app to get there, this is what SliDesk is for.

Four things are built in, not bolted on:

  • A live audience — the room follows your slides on their phone as you present, in the room or from anywhere (how)
  • Native i18n — one source file, many languages, switched by a single CLI flag
  • File includes — split a talk across files and directories with !include()
  • Zero project scaffolding — a .md file and a single Bun binary is a working talk

And your slides can wear your company's colours with one command: slidesk design.

Prove the i18n in 30 seconds

Give the same talk in French and in English from one source file. Three files, no duplication:

# $$title$$

## $$agendaTitle$$

1. $$partIntro$$
2. $$partDemo$$
{
  "default": true,
  "translations": {
    "title": "Ship your talk in two languages",
    "agendaTitle": "Agenda",
    "partIntro": "Introduction",
    "partDemo": "Live demo"
  }
}
{
  "translations": {
    "title": "Votre talk en deux langues",
    "agendaTitle": "Au programme",
    "partIntro": "Introduction",
    "partDemo": "Démo live"
  }
}

Then flip the language with one flag:

slidesk my-talk        # English — the file marked "default": true
slidesk -l fr my-talk  # French — same slides, same theme, same notes

That is the whole feature. No duplicated deck to keep in sync, no per-language branch, no plugin.

It composes with includes

Translation happens after includes are resolved, so $$variables$$ work inside every included file. Keep slides/01-intro.md language-agnostic and let the .lang.json files carry the words.

Details: internationalisation syntax, --lang option, includes.

Your brand in one command

Point SliDesk at your website, get a theme that looks like it:

slidesk design https://example.com          # themes/example-com/theme.css
slidesk design https://example.com --local  # with the fonts downloaded, for offline talks

SliDesk reads the page and its stylesheets and keeps:

  • the background and text colours, the text forced readable on the background
  • the primary colour, used for headings, bold text and links
  • the fonts of the body and of the headings
  • the logo, as a discreet watermark at the bottom right of every slide

No colour picker, no hunting for font names: the result is a plain theme.css you can tweak.

Details: design command, create themes.

Where SliDesk fits

Marp Slidev Typst SliDesk
Markdown-first ✅ ✅ ✗ Typst markup ✅
Runtime to learn — Vue + Vite Typst language + a slides package —
Multi-language from one source ✗ ✗ ✗ (scriptable) ✅ .lang.json + --lang
Slide includes ✗ per file, via src: frontmatter per file, #include ✅ file or directory, one line
Speaker view with timers & notes limited ✅ via pdfpc ✅
Present from a terminal ✗ ✗ ✗ ✅ telnet
Code highlighting ✅ ✅ ✅ via plugin
Math (LaTeX) ✅ ✅ ✅ native via plugin
Overview of all slides ✗ ✅ via pdfpc ✗
Draw on slides while presenting ✗ ✅ via pdfpc ✗
Live preview in the editor ✅ VS Code ✅ VS Code ✅ ✗ live reload in the browser
Export slides as images ✅ ✅ ✅ ✗
Theme generated from a website ✗ ✗ ✗ ✅ slidesk design

Read the full rationale in Why SliDesk?.

Features

  • Markdown to slides — each ## heading creates a new slide
  • Internationalisation — multi-language presentations with .lang.json
  • Includes — split a talk across files and directories with !include()
  • Live reload — edit your slides, the browser updates instantly
  • Speaker view — current + next slide, timer, notes, checkpoints
  • Telnet mode — present from any terminal via telnet
  • Plugin system — extend with front-end scripts, back-end routes, WebSocket handlers
  • Templates & themes — reusable layouts and visual styles
  • Theme from a website — slidesk design <url> takes the colours, fonts and logo of a site
  • Components — custom .mjs modules that transform the source of your talk
  • Hub integration — share and discover addons at slidesk.link
  • Deploy — export static HTML, or CI/CD for GitHub/GitLab Pages

Quick start

# Install via Homebrew (macOS/Linux)
brew tap gouz/tools && brew install slidesk

# Create a new talk
slidesk create my-talk

# Present it
slidesk my-talk

# Open http://localhost:1337

See the installation tutorial for other install methods.

Documentation