Skip to content

Converting slides to a version-controllable format #161

@mjaehn

Description

@mjaehn

It would be nice if we can integrate the slides into this Git repository, including all its advantages.

Options

LaTeX Beamer

  • Pro: We already have our C2SM beamer template
  • Pro: Excellent diffs; changes to bullet points, diagrams, etc. are perfectly readable in git diff
  • Con: Verbose syntax for simple content (code blocks, bullet lists)
  • Con: Requires a LaTeX toolchain to compile

Markdown Slides

Tool Output Notes
Marp HTML, PDF, PPTX VS Code extension available, simplest setup
Slidev HTML (Vue-based) Code highlighting, animations, very dev-friendly
Quarto + reveal.js HTML, PDF Also exports to Beamer via pandoc
pandoc Beamer PDF Bridges both worlds — write Markdown, render with your existing LaTeX template

Ideal Solution

pandoc + Markdown → Beamer

  • Writing slides in plain Markdown (consistent with existing .md exercises)
  • pandoc renders them (e.g. using C2SM Beamer template)
  • No new toolchain beyond pandoc (one binary, available everywhere)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions