dudecalledbro/mkslides repository overview

⁠MkSlides

This repository provides a Docker image for MkSlides⁠.

docker pull dudecalledbro/mkslides:latest

⁠Usage

You can easily build and serve presentations using Docker:

⁠Build a Presentation

docker run \
  --mount type=bind,src=./slides,dst=/slides \
  --rm \
  dudecalledbro/mkslides:latest mkslides build test.md

This command mounts your local slides directory into the container and builds test.md into a presentation.

⁠Serve a Presentation Locally

docker run \
  --mount type=bind,src=./slides,dst=/slides \
  --publish 8000:8000 \
  --rm \
  dudecalledbro/mkslides:latest mkslides serve --dev-addr 0.0.0.0:8000 test.md

Your presentation will be available at http://localhost:8000⁠.

⁠Build

This image build is scheduled with GitHub Actions and will be pushed to DockerHub. The image will also be rebuilt, if the main branch is updated. If you need to build the image locally, ensure Docker⁠ is installed and execute the following:

docker build -t mkslides:latest .

⁠License

Copyright (c) 2026 Niclas Spreng