Show HN: MkSlides – Markdown to slides with a similar workflow to MkDocs

Hacker News (score: 15)
Found: November 27, 2025
ID: 2517

Description

Build/Deploy
Show HN: MkSlides – Markdown to slides with a similar workflow to MkDocs As a teacher, we keep our slides as markdown files in git repos and want to build these automatically so they can be viewed online (or offline if needed). To achieve this, I have created MkSlides. This tool converts all markdown in a folder to slides generated with Reveal.js. The workflow is very similar to MkDocs.

Install: `pip install mkslides`

Building slides: `mkslides build`

Live preview during editing: `mkslides serve`

Comparison with other tools like marp, slidev, ...:

- This tool is a single command and easy to integrate in CI/CD pipelines.

- It only needs Python.

- The workflow is also very similar to MkDocs, which makes it easy to combine the two in a single GitHub/GitLab repo.

- Generates an index landing page for multiple slideshows in a folder which is really convenient if you have e.g. a slideshow per chapter.

- It is lightweight.

- Everything is IaC.

More from Hacker

Log level 'error' should mean that something needs to be fixed

Log level 'error' should mean that something needs to be fixed

Chafa: Terminal Graphics for the 21st Century

Chafa: Terminal Graphics for the 21st Century

Stoolap: High-performance embedded SQL database in pure Rust

Stoolap: High-performance embedded SQL database in pure Rust

Debugging TLS failures in distroless containers

Debugging TLS failures in distroless containers

No other tools from this source yet.