GitHub - slidesdown/slidesdown: Presentations at the speed of Markdown

Presentations at the speed of Markdown

Slidesdown is powered by the incredible reveal.js presentation framework.

Learn

Visit slidesdown.github.io/learn.html to get started.

Usage: View Slides

Online Viewer

Visit slidesdown.github.io/loader.html and enter the URL to your Markdown presentation, e.g. github.com/slidesdown/slidesdown/SLIDES.md.

CLI

Slidesdown provides a CLI to quickly open files on your computer in the Online Viewer or a viewer hosted in a local Docker container that can be used fully offline (i.e. perfect for presentations you want to keep private).

Installation

sudo curl -L https://raw.githubusercontent.com/slidesdown/slidesdown/main/slidesdown -o /usr/local/bin/slidesdown; sudo chmod a+x /usr/local/bin/slidesdown

slidesdown CLI has the following dependencies:

nu required interpreter for the slidesdown programm.
docker required for offline presentations and hot-reloading slides while editing.

Optional dependencies if docker isn't used:

python3 required for online presentations via slidesdown.github.io if the slideshow file shall be served from the local computer, i.e. useful for creating slides or when the presentation is private and shall not be made accessible publicly via GitHub.
decktape or docker for exporting slideshows as PDF.

Installation with Nix Flake

Add the slidesdown section to your Flake's inputs:

inputs = {
  # (...)
  slidesdown = {
    url = "github:slidesdown/slidesdown/main";
    inputs.nixpkgs.follows = "nixpkgs";
  };
};

Add the following to your nixpkgs.overlays:

(final: prev: {
  # (...)
  slidesdown = import inputs.slidesdown {
    inherit system;
    inherit (prev) pkgs;
  };
})

Rebuild your configuration (nixos-rebuild switch --flake your-system-config) and check if it works with slidesdown --help.
Display your presentation

slidesdown # opens the browser and displays the presentation

One-time Usage with `nix run`

nix run github:slidesdown/slidesdown

Update

Open local file in slidesdown Offline Viewer (docker required)

Navigate to any folder with a SLIDES.md file, then run this command:

Open local file in slidesdown Online Viewer (python3 required)

Attention: The file with not transmitted to any online service! It will only be served from a local web server to your local browser!

Navigate to any folder with a SLIDES.md file, then run this command:

Export Slides as PDF

The exporter can also be used via Docker:

If a local decktape installation exists, it can also be used like this:

Usage: Create Slides

Simple

Create a file called SLIDES.md and add your content. Once done, publish it online and open the presentation in the online viewer or use the CLI to do so.

Use Template

There are multiple options for starting with a template that includes meta data and useful configuration options:

Download from GitHub:

curl -sflO https://raw.githubusercontent.com/slidesdown/slidesdown/main/examples/SLIDES.md

Use CLI:

Copy template from here:

---
# This is a Slidesdown presentation. Learn about Slidesdown at https://slidesdown.github.io

# Metadata about the presentation:
title: Presentation Title
subject: My super presentation
author: Your Name
date: 2023-01-20
keywords: some useful keywords

# Presentation settings:
# URL to favicon
favicon: /favicon.svg
# Theme, list of supported themes: https://github.com/slidesdown/slidesdown.github.io/tree/main/vendor/reveal.js/dist/theme
theme: white
# Code highlighting theme, list of supported themes: https://github.com/slidesdown/slidesdown.github.io/tree/main/vendor/highlight.js
highlight-theme: tokyo-night-dark

# Show progress bar
progress: true
# Show controls
controls: true
# Center presentation
center: true
# Create separate pages for fragments
pdfSeparateFragments: false
# Loop the presentation
loop: false
# Controls automatic progression to the next slide
# - 0:      Auto-sliding only happens if the data-autoslide HTML attribute
#           is present on the current slide or fragment
# - 1+:     All slides will progress automatically at the given interval in milliseconds
# - false:  No auto-sliding, even if data-autoslide is present
autoSlide: 0
# Activate the scroll view (disables 3d navigation), see https://revealjs.com/scroll-view/
# view: scroll
# Full list of supported settings:
# - https://revealjs.com/config/
# - https://github.com/hakimel/reveal.js/blob/master/js/config.js
# - https://github.com/slidesdown/slidesdown/blob/main/public/plugin/slidesdown.js#L758
# UnoCSS styling: https://unocss.dev/interactive/ and https://tailwindcss.com/docs
# Icons: https://icones.js.org and https://unocss.dev/presets/icons
---

# My first markdown slideshow

Author: Your Name

<!-- generated with
!deno run --allow-read --allow-write https://deno.land/x/remark_format_cli@0.4.0/remark-format.js --maxdepth 2 %
-->

## Agenda

1. [A horizontal Slide](#a-horizontal-slide)
2. [More Examples](#more-examples)

## A horizontal Slide

- More icons at
  [Icônes <div class="i-fa6-solid-face-smile inline-block m-auto"></div>](https://icones.js.org)

notes:

- Some
- speaker
- notes

### A veritical Slide

- More class styles at [tailwindcss](https://tailwindcss.com/docs) via
  [UnoCSS](https://unocss.dev/interactive/)

## More Examples

https://github.com/slidesdown/slidesdown/blob/main/SLIDES.md

---

<h2>The End</h2>

Thank you for your time.

Publish Slides

GitHub Repository

Use the GitHub CLI - gh

gh repo create myslides --public --clone
slidesdown -t
# edit slides ...
git add SLIDES.md
git commit -m "first slideshow"
git push

Now, open the presentation in the online viewer:

xdg-open "https://slidesdown.github.io/?slides=$(gh browse -n)"

GitHub Gist