30-second slideshows for hackers with blackjack and hookers. In fact, forget the slideshows!
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



30-second slideshows for hackers with blackjack and hookers. In fact, forget the slideshows!

What is Bochar?

Bochar [bɔʧar] is a Cleaver wrapped in Shower Ribbon.

What is Bochar?

So let's talk about Cleaver.

What is Cleaver?

Cleaver turns the following:

title: My Slideshow
output: slideshow.html
## Hello, world!
### This is my slideshow

What is Cleaver?

Into a slideshow like this slideshow.

Cleaver uses a simple Markdown format.

  • Simply write your slides in Markdown
  • … and separate them with --

What is Cleaver?

Cleaver comes with a stylesheet that looks good by default, but that you can extend at your heart's desire.

Return to Bochar

Getting Bochar

Get Bochar from NPM

npm install -g bochar

Generation with Bochar

And run it against your shiny new presentation

bochar path/to/presentation.md

Continuous generation with Bochar

If you want watching your md-file and regenerate presentation, just add watch command:

bochar watch path/to/presentation.md

Next we'll talk about setting up a quick presentation.


Each presentation contains metadata, for example:

title: Shower Ribbon + Cleaver = Bochar
  name: "Vladimir Starkov"
  twitter: "@matmuchrapna"
  url: "http://vstarkov.com"
output: index.html

Let's break this chunk down on the next slide.

Metadata Fields

  • title: The title of your presentation
  • author: Some fields to populate an optional author slide at the end
  • style: An optional external stylesheet to load
  • output: Where to save your file (default: FILENAME-cleaver.html)

Metadata Fields

  • controls: Option to render navigation buttons (default: true)
  • agenda: Option whether or not to insert an agenda slide (similar to a table of contents) after the title (default: false)
  • encoding: A specified content encoding (default: utf-8)

Metadata Fields (Advanced)

  • template: Location of the template used to render the slides (default: default.mustache)
  • layout: Location of the layout template used to render everything (default: layout.mustache)

Other Slides

Slides are separated by -- and are written in markdown.

Use h2 to define slide's title (denoted ##)

Author Slide

If your metadata contains author information (name, url, twitter), an author slide will be inserted at the end of your presentation.

That's all, folks!

Seriously, that's it. Bochar is perfect for quick slideshows that you can create using a comfortable format with Shower ribbon template. No extra software or text boxes required.

Check us out on GitHub.