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.

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:

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/65 or 25/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: or rows: 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 metadata
  • colloquium-title-rule — short accent line
  • colloquium-title-meta — vertical stack for byline / venue / date
  • colloquium-title-name — larger author line
  • colloquium-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: center usually works best
  • title-left: top, center, and bottom are all reasonable
  • title-banner: use carefully; the layout is intentionally top-weighted
  • title-sidebar: top, center, and bottom are 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:

  1. Start with title-left.
  2. Switch to title-sidebar if the title wraps too much.
  3. Use title-banner only when you want a deliberately more designed look.