Remark

No Change
trial
First Added:October 1, 2024 Updated: July 29, 2026

Remark is an in-browser Markdown slideshow: one HTML file, CSS, and JS. We trial it under Presentation when slides should live in Git as plain text instead of PowerPoint or Keynote.

Blurb

A simple, in-browser, Markdown-driven slideshow tool targeted at people who know their way around HTML and CSS.

Summary

What it is: Browser-rendered decks from Markdown. Slide breaks are --- lines. Presenter mode, clone view, syntax highlighting, and CSS-based styling.

When to use:

SituationNotes
Info-heavy talksText, images, and Mermaid with low tooling overhead
Tech talks in GitVersion slides next to the code you demo
Offline / simple hostingSingle HTML file; Dropbox or GitHub Pages
Custom lookStyle with normal CSS and content classes

When to skip:

  • Non-technical authors who need WYSIWYG slide apps
  • Heavy animation or corporate template lock-in
  • Teams already standardized on Reveal.js or Marp with shared themes

Trade-offs: Low effort when the deck is mostly information, not spectacle. Layout power is CSS skill, not a slide designer. Project is mature and quiet; expect DIY maintenance.

Details

Slide Properties

Initial key-value lines on a slide become properties:

  • name and class for naming and styling
  • template and layout for reuse
  • {{ property }} expands to property values

See the slide properties wiki.

Other Extensions

  • Content classes: .footnote[.red[*] note] wraps spans with CSS classes
  • Fenced code blocks with language tags for highlighting
  • ??? separates slide body from presenter notes (P toggles presenter mode; C clones the view)

References