Colloquium
Markdown-first slides for research talks. The website is intentionally small: start with the hello deck, then browse the focused examples. The main documentation stays in the repository README.
Built by Nathan Lambert.
Explore Colloquium README PyPI GitHub★ 105
Quick start
uv tool install colloquium # install the CLI on your PATH
# or inside a project/venv:
# uv pip install colloquium # install into the active project environment
uv run colloquium build examples/hello/hello.md # build self-contained HTML
uv run colloquium serve examples/hello/hello.md # launch local preview server
uv run colloquium export examples/hello/hello.md # export PDF via Chromium
Core features
What makes Colloquium especially useful for academics and for building slides with agents:
- Markdown native
- Equations and code highlighting
- BibTeX via Pybtex
- Charts
More coming soon.
Get started
Hello Colloquium
This is the broad feature tour deck.
Click for more details
This is the broad feature tour deck.
Use it when you want one example that touches most of the default authoring surface:
- math
- code highlighting
- columns
- centered content
- charts
- citations
- conversation blocks
- box callouts
- footnotes
All examples
Footnotes · Rows and Columns · Title Slide Options
Footnotes
This example deck shows the two supported footnote patterns:
Click for more details
This example deck shows the two supported footnote patterns:
- inline numbered footnotes with
^[...] - floating slide notes with
<!-- footnote: ... -->or<!-- footnote-right: ... -->
Patterns in footnotes.md:
- one inline numbered footnote on the right
- two inline numbered footnotes on the same slide
- inline numbered footnotes positioned on the left with
<!-- footnotes: left --> - inline numbered footnotes stacked with a floating citation
- a plain unnumbered floating slide note
Basic usage:
This sentence has a footnote marker.^[This renders as a numbered note above the footer.]
Move inline numbered footnotes to the left:
<!-- footnotes: left -->
Plain floating slide note without an inline marker:
<!-- footnote-right: This note lives in the footer area without adding a marker in the body. -->
Rows and Columns
Use this when a slide needs stacked sections, nested subcolumns, or a big visual row without resorting to custom CSS.
Click for more details
Use this when a slide needs stacked sections, nested subcolumns, or a big visual row without resorting to custom CSS.
- slide-level
rows: - the
===row divider - row-local
row-columns: - arbitrary ratios such as
35/65or25/75 - image fitting inside row/grid boxes by default
Patterns in rows-and-columns.md:
- simple top-text / bottom-visual slide
- top row split into columns, bottom row full width
- big image on top with a short note row below
- three equal rows
Basic usage:
<!-- rows: 35/65 -->
## Slide title
Top row
===
Bottom row
Nested columns inside a row:
<!-- rows: 35/65 -->
## Slide title
<!-- row-columns: 40/60 -->
Left
|||
Right
===
Bottom row
Notes:
- Use
columns:orrows:at the slide root, not both. - Use
row-columns:only inside a row block. - Ratios are not limited to presets; any numeric split is allowed.
- Images fit their row/grid box by default; add
<!-- img-overflow: true -->if you want a deliberate bleed.
Title Slide Options
Copy these built-in title layouts into real talks when you want a stronger opening slide without custom CSS.
Click for more details
Copy these built-in title layouts into real talks when you want a stronger opening slide without custom CSS.
Files:
title-slides.md— the source deck- build locally with
uv run colloquium build examples/title-slides/title-slides.md
Built-in Title Layouts
title
Centered title slide. Best for short titles and minimal metadata.
# My Talk Title
<div class="colloquium-title-eyebrow">Conference</div>
<div class="colloquium-title-rule"></div>
<div class="colloquium-title-meta">
<p class="colloquium-title-name">Jane Doe</p>
<p>Institution</p>
<p>March 2026</p>
</div>
title-left
Left-aligned title slide with the whole composition vertically centered by default. This is the strongest default for research talks.
<!-- layout: title-left -->
# Building Useful Language Models
<div class="colloquium-title-eyebrow">Invited Talk</div>
<div class="colloquium-title-rule"></div>
<div class="colloquium-title-meta">
<p class="colloquium-title-name">Jane Doe</p>
<p>Institution</p>
<p>March 2026</p>
</div>
<p class="colloquium-title-note">One sentence of framing copy.</p>
title-sidebar
Wide title with a metadata rail on the right. Best when the title is long.
<!-- layout: title-sidebar -->
# An Introduction to Reinforcement Learning from Human Feedback
<div class="colloquium-title-eyebrow">Tutorial</div>
<div class="colloquium-title-rule"></div>
<div class="colloquium-title-meta">
<p class="colloquium-title-name">Jane Doe</p>
<p>Institution</p>
<p>March 2026</p>
</div>
<p class="colloquium-title-note">Use this when centered titles start feeling too tall.</p>
Optional rail behavior:
- default: the vertical rule tracks the right-hand content block
<!-- class: title-sidebar-rule-full -->: stretch the rule the full height of the right column
<!-- layout: title-sidebar -->
<!-- class: title-sidebar-rule-full -->
title-banner
Headline high on the slide, metadata lower on the slide. Useful when you want a more editorial composition.
<!-- layout: title-banner -->
# Post-Training for Useful Language Models
<div class="colloquium-title-eyebrow">Research Talk</div>
<div class="colloquium-title-rule"></div>
<div class="colloquium-title-meta">
<p class="colloquium-title-name">Jane Doe</p>
<p>Institution</p>
<p>March 2026</p>
</div>
<p class="colloquium-title-note">Short framing copy goes here.</p>
Built-in Title Utility Classes
These classes are available in the default theme and are safe to copy:
colloquium-title-eyebrow— small uppercase kicker above metadatacolloquium-title-rule— short accent linecolloquium-title-meta— vertical stack for byline / venue / datecolloquium-title-name— larger author linecolloquium-title-note— subdued framing note
Vertical Positioning
valign is a global utility, so it can affect title slides too:
<!-- valign: top --><!-- valign: center --><!-- valign: bottom -->
Current guidance:
title:centerusually works besttitle-left:top,center, andbottomare all reasonabletitle-banner: use carefully; the layout is intentionally top-weightedtitle-sidebar:top,center, andbottomare supported
Example:
<!-- layout: title-left -->
<!-- valign: bottom -->
# My Talk Title
<div class="colloquium-title-meta">
<p class="colloquium-title-name">Jane Doe</p>
<p>Institution</p>
</div>
Recommended Starting Point
If you are not sure which layout to choose:
- Start with
title-left. - Switch to
title-sidebarif the title wraps too much. - Use
title-banneronly when you want a deliberately more designed look.