blog.sh vs mdBook

blog.sh and mdBook are both open source static site generators. blog.sh is written in Bash and mdBook is written in Rust.

Property blog.sh mdBook
Language Bash Rust
Templates Custom Handlebars
License MIT MPL-2.0

blog.sh benefits

blog.sh is a relatively simple static blog generation tool written in bash. It supports markdown (via pandoc, but other converters could be used) and a very basic templating system. It is designed for simplicity and easy of hacking.

Features

  • Create new
  • Save to draft
  • Edit existing or draft
  • Complete rebuild of site (good for updating template)
  • Basic templating
  • RSS 2.0

Planned (aka things I haven't found time for)

  • Default .config file
  • Default basic template (one doesn't exist)
  • Static page support
  • Document classes and ids available for CSS
  • Delete post

blog.sh was heavily inspired by Carlos Fenollosa's bashblog.

mdBook benefits

Create book or documentation from markdown files as with GitBook.

Highlights:

  • Handlebars templates
  • Math equations through MathJax
  • Can be used as a library
  • Runnable Rust code snippet using Rust Playpen

Used by "The Rust Programming Language" book.