Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

A Sinatra script to serve a hierarchy / tree directory of markdown files. Use intended for small sites built in markdown.

branch: master
README.md

Markdown Tree

What is it?

Take a folder with a hierarchy of markdown files and use this script to serve that folder as a live styled site with a built in navigation.

Basically this is a Sinatra script to serve a hierarchy / tree directory of markdown files as a live dynamic site. Use intended for small sites built in markdown.

Why

There are many similar scripts done in a static fashion but I couldn't find a minimal system for serving markdown hierarchy based sites that was dynamic.

For that reason I created Markdown Tree. Having a dynamically generated site allows me to not have to worry about regenerating my site every time I make a minor change.

Installation and Usage

  • Clone the repo: git clone git://github.com/mil/markdown-tree.git
  • Go into the directory: cd markdown-tree
  • Install the Sinatra and Redcarpet gems: gem install redcarpet sinatra
  • Run the script: ruby markdown-tree.rb
    • Visit http://localhost:4567 to browse your site!

Folder Structure / Customization

  • markdown-tree.rb : The ruby script to run which serves your site
  • config.yaml : 4 option config used by markdown-tree.rb
  • template/ : Contains the default template
    • template.erb : ERB template pages are built from
  • content/ : Contains the hierarchy of markdown files for your Sites

Example Sites

Todos

  • Clean up the default template's CSS
  • Add more error handling for reading file

Credits

Something went wrong with that request. Please try again.