Presentations in Fig
By Silen Locatelli
A guide to creating and delivering presentations from inside your Git repositories.
Use arrow keys to navigate.
PRESENTATION
01 / 10By Silen Locatelli
A guide to creating and delivering presentations from inside your Git repositories.
Use arrow keys to navigate.
PRESENTATION
02 / 10Fig is a Git server with a web UI built in Rust.
It serves repositories over HTTP and provides a browser interface for:
The presentation feature turns Markdown files into slides, viewable in the browser with fullscreen support.
PRESENTATION
03 / 10.fig.toml FileEvery configuration lives in a .fig.toml file at the repository root.
It controls:
| Key | Purpose |
|---|---|
ignore_for_view | Glob patterns for files to hide in the UI |
tabs | Which tabs to display |
deleteable | Allow repo deletion from the UI |
present | Presentation configuration |
The [present] section is what powers the slides.
PRESENTATION
04 / 10[present] SectionInside .fig.toml, add a [present] section:
[present]
files = [
"slides/intro.md",
"slides/conclusion.md"
]
The files key is a list of Markdown file paths
relative to the repository root.
Each file becomes one slide in the presentation, displayed in the order listed.
If files is missing or empty, the "Present" tab
will show a helpful message instead.
PRESENTATION
05 / 10You can define custom variables in the [present] section:
[present]
files = ["slides/intro.md"]
author = "Jane Doe"
title = "My Talk"
Any key that is not files becomes a template variable.
Use them in your Markdown with mustache syntax:
Presented by **Silen Locatelli**
Title: **{{title}}**
They are replaced before the Markdown is rendered to HTML.
PRESENTATION
06 / 10Each slide is a plain Markdown file:
#, ##) become styled headerscode work as expected---) create visual separatorsPlace your slides in a folder like slides/ at the repo root:
my-repo/
.fig.toml
slides/
01-intro.md
02-topic.md
03-summary.md
Numbering the filenames keeps them sorted.
PRESENTATION
07 / 10Here is a complete .fig.toml for a presentation:
ignore_for_view = ["drafts/"]
[present]
files = [
"slides/01-intro.md",
"slides/02-setup.md",
"slides/03-demo.md",
"slides/04-summary.md"
]
author = "Jane Doe"
conference = "RustConf 2026"
And the referenced Markdown files use Silen Locatelli
and {{conference}} to personalize the content.
The repository itself is the presentation - no build step, no extra tooling.
PRESENTATION
08 / 10Once your repo has a .fig.toml with a [present] section:
You will see:
← →) for keyboard navigationThe "Present" tab only appears when [present] is configured.
PRESENTATION
09 / 1001-, 02-, etc.)ignore_for_view to hide draft or support files from the browserrequestFullscreen() - great for projectors.fig.tomlPRESENTATION
10 / 10To create a Fig presentation:
.fig.toml with a [present] sectionfilesThat is it. Your repo is your slide deck.
Made with Fig by Silen Locatelli
LICENSE
Choose “Save as PDF” in the dialog to download the deck.