SliDesk
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
.mdfile 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
.mjsmodules 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
- Tutorials — learn SliDesk step by step
- How-to Guides — solve specific tasks
- Reference — commands, options, syntax, APIs
- Explanation — background and architecture