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

Summary

MkSlides Use mkslides to easily turn Markdown files into beautiful slides using the power of Reveal.js! MkSlides is a static site generator that's geared towards building slideshows. Slideshow source files are written in Markdown, and configured with a single YAML configuration file. The workflow and commands are heavily inspired by MkDocs and reveal-md. Features Build static HTML slideshow files from Markdown files. Turn a single Markdown file into a HTML slideshow. Turn a folder with Markdown files into a collection of HTML slideshows with an index landing page. Publish your slideshow(s) anywhere that static files can be served. Locally on your own device. On a web server. Deploy through CI/CD with GitHub/GitLab (like this repo!). Preview your site as you work, thanks to python-livereload. Use custom favicons, CSS themes, templates, ... if desired. Support for emojis 😄 🎉 🚀 ✨ thanks to emoji Depends heavily on integration/unit tests to prevent regressions. And more! Example Example slide from https://martenbe.github.io/mkslides with dracula theme: Example index page from https://hogenttin.github.io/hogent-markdown-slides with HOGENT theme, custom title, and custom background logo: Example output when building the website: Example output when using live preview during editing: Longer video: Want more examples? An example repo with slides demonstrating all possibilities (Mermaid.js and PlantUML support, multicolumn slides, image resizing, ...) using Reveal.js with the HOGENT theme can be found at https://github.com/HoGentTIN/hogent-markdown-slides . Installation pip install mkslides Create static site E.g. when your Markdown files are located in the slides/ folder: mkslides build If the slides folder doesn't exists, it will fallback to docs for backwards compatibility. If docs also doesn't exists, it will error. E.g. when your Markdown files are located in the somefolder/ folder: mkslides build somefolder/ E.g. when you have a single Markdown file called test.md : mk...