# Markdown slideshow with Reveal.js in NixOS

Posted in category nixos on 2017-10-16

Building and installing mdslider is as easy as running following commands on your NixOS:
$git clone https://github.com/kuznero/mdslider ./$ nix-build shell.nix
$nix-env -i ./result To check that you got it properly installed, just run mdslider in your shell - you should see the following output: Expected arguments are missing: SLIDES_FILE TARGET_DIR PORT THEME TRANSITION TITLE Example: mdslider slides.md ./out 8080 sky concave "Super cool slides" Supported themes: beige, black, blood, league, moon, night, serif, simple, sky, solarized, white Supported transitions: none, fade, slide, convex, concave, zoom That indicates that mdslider is ready to serve your first slide deck now. ## Starting the slideshow Now, let’s create and start your first slide deck with mdslider! You will need to use ===== on its own line for horizontal slides, and ----- - for vertical slides. Let’s assume you have you markdown file created now, slides.md. In order to start the slideshow with mdslider you will need to run the following command: $ mdslider slides.md ./out 8181 sky fade "My First Slideshow with mdslider"
It will start a very simple http server that will serve all the necessary content from just generated ./out folder. Simply navigate to 127.0.0.1:8181 and observe how cool Reveal.js is and how little you need to fiddle with raw html and javascript.
And you can keep editing your slides.md file in its original location - you will just need to refresh the browser after you saved your changes.