Use markdown to write contents and render with WebSlides to HTML.


WebSlides Demos

Here’s what you can do with WebSlides.

More Examples

Note. None of these slides are currently not ported to Hugo-Webslides…YET.


You can modify WebSlides settings directly from your project config.toml.

  banner = false
  slideshow = true
  vertical = false
  autoslide = false
  changeOnClick = false
  disableLoop = false
  minWheelDelta = 40
  disableNavigateOnScroll = false
  scrollWait = 450
  slideOffset = 50
  hideIndex = false

All from one markdown file

Use three dashes “-” to create a separate slide page.




├── home
│   ├── (weight: 1)
│   └── (weight: 2)
└── (initial page)

Or not.

You can combine and arrange files with the weight parameter in front matter, and categorize .md files into different folders.

Simple Class Assignment

Assign class to a block by using the following notation without quote.

<!-- : .class -->Content

You can assign class to many elements

  • Slides

    <!-- : sectionClass .divClass ..subClass -->

    <section class="sectionClass">
      <div class="divClass">
        <div class="subClass">
  • Headers and Paragraphs

    # <!-- : .hClass -->Header
    <!-- : .pClass -->Paragraph

    <h1 class="hClass">Header</h1>
    <p class="pClass">Paragraph</p>
  • Lists

    <!-- : .listClass -->
    - list1
    - list2

    <ul class="listClass">

Install Now

Run from the root of your Hugo site:

$ git clone themes/hugo-webslides

Good Karma

WebSlides — HTML presentations made easy.
Hypertext and beauty as narrative elements.

Twitter Dribble Github

Everyone Stories

Why WebSlides?

"I feel guilty as a web designer when I have to use PowerPoint and Keynote. So I made #WebSlides."

Avatar @jlantunez.

WebSlides is really easy

Each parent <section> in the #webslides element is an individual slide.

Code is clean, scalable, and well documented. It uses intuitive markup with popular naming conventions. There’s no need to overuse classes or nesting. Based on SimpleSlides, by Jenn Schiffer :)

<article id="webslides">
  <!-- Slide 1 -->
    <h1>Design for trust</h1>
  <!-- Slide 2 -->
  <section class="bg-primary">
    <div class="wrap">
      <h2>.wrap = container (width: 90%)</h2>

WebSlides was made to inspire people.

There are excellent presentation tools out there. WebSlides is an open source solution for telling stories. Hypertext and beauty as narrative elements.

  • Keyboard navigation

    with arrow keys.
  • Go to a specific slide

    URL: #slide=number
  • Slide counter

    Current/Total number.
  • 100% customizable

    Well documented.
  • 40+ Beautiful Components

    Covers, cards, quotes...
  • Flexible blocks

    with auto-fill and equal height.
  • Vertical rhythm

    Use multiples of 8.
  • Fade transition

    to all slides.
  • 500+SVG Icons

    Font Awesome Kit.


Making a beautiful HTML presentation has never been so rewarding.

WebSlides Files


The best way to inspire with your content is to connect on a personal level: