#markdown #slides

bin+lib mdslides

A tool to convert markdown into reveal.js slides

4 releases (2 breaking)

0.3.0 May 23, 2023
0.2.0 Apr 24, 2023
0.1.1 Apr 21, 2023
0.1.0 Apr 21, 2023

#108 in Template engine

Download history 38/week @ 2023-04-15 162/week @ 2023-04-22 126/week @ 2023-04-29 18/week @ 2023-05-06 116/week @ 2023-05-13 83/week @ 2023-05-20 44/week @ 2023-05-27

275 downloads per month

Apache-2.0 OR MIT

19KB
388 lines

mdslides

A tool for turning mdbooks into slide shows.

Written by Ferrous Systems. Contact us for Rust training, or help with your next Rust project.

Installation

The crate is built with cargo-dist. You can grab binaries from the release area on Github: https://github.com/ferrous-systems/mdslides/releases

Usage

Run the tool, passing the source of your mdbook of slides, and a template HTML file:

$ mdslides --mdbook-path ~/Documents/my-slides --output-dir ./html --template ~/Documents/my-slides/template.html

It will create a new HTML file for every chapter in your mdbook. Each HTML file will be a copy of the template, but with the string $TITLE replaced with the title of the chapter, and the string $CONTENT replaced with the Markdown source of that chapter. Additionally, each # Heading or ## Subheading in the Markdown will have an --- divider added before it. The reveal.js framework uses this to indicate when a new page is required, so each heading them forms a new slide.

You can also pass --index-template ./index-template.html and a file called ${OUTPUT_DIR}/index.html will be created using that template, replacing $INDEX with a series of HTML headings, subheadings and links to each slide deck.

You can see an example of using this tool at https://github.com/ferrous-systems/material-templates.

Changelog

See CHANGELOG.md

License

This crate is distributed under the terms of both the MIT license and the Apache License (Version 2.0).

See LICENSE-APACHE, LICENSE-MIT, and COPYRIGHT for details.

Dependencies

~3.5–5MB
~110K SLoC