---
name: "darkslide"
section: "1"
platform: "linux"
package: "darkslide"
version: "6.0.0-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/darkslide"
---

# darkslide(1)

html5 slideshow generator

## NAME

darkslide - html5 slideshow generator

## SYNOPSIS

**darkslide** \[*options*\] *input.md* ...

## DESCRIPTION

Darkslide is a tool which can generates an HTML5 slideshow using lightweight markup as input.

You can write your slide contents easily using there syntaxes:

- **Markdown**

  - **ReStructuredText**

  - **Textile**

  This tool support CSS/JS theming, embed images with Base64 (for stand-alone document) and fancy transitions.

A sample presentation is available here: \<http://ionelmc.github.io/python-darkslide/\>.

## OPTIONS

- **-h**, **--help**

  Show help message and exit

- **-b**, **--debug**

  Print exception traces to stderr

- **-d** *FILE*, **--destination**=*FILE*

  The path to the to the destination file: .html or .pdf extensions allowed (default: presentation.html)

- **-e** *ENCODING*, **--encoding**=*ENCODING*

  Encoding of the input files (defaults to UTF-8)

- **-i**, **--embed**

  Embed stylesheet and javascript contents, base64-encoded images in presentation to make a standalone document

- **-l** *LINENOS*, **--linenos**=*LINENOS*

  How to output linenos in source code. Three options are available: no (no line numbers); inline (inside \<pre\> tag); table (lines numbers in another cell, copy-paste friendly)

- **-m** *LEVEL*, **--max-toc-level**=*LEVEL*

  Limit the TOC level generation to a specific level

- **-M** *MOD*, **--mod**=*MOD*

  Specify a theme modifier by name. Available: wide16x9

- **-o**, **--direct-output**

  Print the generated HTML code to stdout

- **-P**, **--no-presenter-notes**

  Don't include presenter notes in the output

- **-q**, **--quiet**

  Don't write anything to stdout (silent mode)

- **-r**, **--relative**

  Make your presentation asset links relative to current pwd; This may be useful if you intend to publish your html presentation online.

- **-t** *THEME*, **--theme**=*THEME*

  A theme name, or path to a darkslide theme directory

- **-v**, **--verbose**

  Write informational messages to stdout (enabled by default)

- **-w**, **--watch**

  Watch the source directory for changes and auto-regenerate the presentation

- **-x** *EXTENSIONS*, **--extensions**=*EXTENSIONS*

  Comma-separated list of extensions for Markdown

## AUTHOR

Damien Raude-Morvan \<drazzib@debian.org\>