Reveal.js as git submodule --------------------------- Reveal.js is nice, but the default instruction is to dump their entire codebase into your repository. Not desirable. This proposes an alternate approach, including reveal.js as a git submodule. Create your project:: mkdir slides git init git submodule add https://github.com/hakimel/reveal.js revealjs git submodule update --init --recursive Copy the example and replace paths:: cp revealjs/index.html . sed -i 's|dist/|revealjs/dist/|g' index.html sed -i 's|plugin/|revealjs/plugin/|g' index.html Test it:: firefox index.html While reveal.js can run without a web server, some functionality (like including markdown files) actually requires a web server. It is also easier to use since it will auto reload on file changes. Create a simple one with auto reload:: npm install --no-save browser-sync npx browser-sync start -s -f . --no-notify --port 9000