# arnehilmann/markdeck

presentations as code - author cool slide decks, text-only, offline-ready, collaborative

Repository: https://github.com/arnehilmann/markdeck
Canonical: https://ross.abutalabs.com/products/markdeck
Homepage: https://arnehilmann.github.io/markdeck/
Language: HTML
License: MIT
License Family: permissive
Topics: slide-deck, markdown, markdown-to-html, revealjs, pandoc, pandoc-filter, plantuml, ditaa, graphviz, mathjax, asciinema, ascii-art, decktape, vega-lite, presentation
Last push: 2023-02-04T02:14:29+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3214, "days_push": 1307, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1273, forks 37 (observed 2026-08-28T04:04:12.639638+00:00)

## What it is
Markdeck is a command-line tool that converts markdown source files into polished HTML5 slide decks built on reveal.js (and impress.js), with PDF export and live rendering. It works fully offline, supports diagrams (plantuml, graphviz, ditaa, ascii-art), math, charts, and recorded terminal sessions, and its text-only format makes decks easy to version and collaborate on.

## Use cases
- create presentations from markdown
- generate slide decks as code
- convert markdown to reveal.js slides
- make offline presentations that don't need internet
- export slides to pdf from markdown
- collaborate on slide decks with git
- render ascii-art diagrams in slides

## When to choose
- you want text-only, version-controllable presentations
- you need to present without an internet connection
- you want diagrams, math, and code highlighting in slides without manual tooling
- you prefer writing slides in your own editor with live preview

## When to avoid
- you need PowerPoint/Keynote-style WYSIWYG editing
- you require cloud-based collaborative editing like Google Slides
- you need heavy animations or non-HTML presentation formats
- you want a tool with frequent updates and active maintenance

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: static-site-generator, templating, markdown, pdf
- domain: developer-tools, documentation, web-development
- platform: cli
- tags: presentations, slide-deck, revealjs, pandoc, markdown-to-html, offline-first, diagrams, macos, linux, web-server

## Member repositories
- arnehilmann/markdeck (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:12.639638+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T05:03:12.285394+00:00, confidence not recorded.
  - readme: https://github.com/arnehilmann/markdeck (fetched 2026-08-28T04:04:12.639638+00:00, sha da03e1f993c3)
  - homepage: https://arnehilmann.github.io/markdeck/ (fetched 2026-08-29T12:14:22.453275+00:00, sha 76f24df3b819)
- Data as of 2026-08-30T08:39:29.467469+00:00.