Simple Ruby code for parsing markdown in a directory (Github flavoured Markdown, that is).

Gemfile

# Run 'bundle' in the command line afterward
source 'https://rubygems.org'

gem 'guard'
gem 'guard-rake'
gem 'rake'
gem 'rainbow'
gem 'github-markdown'

Guardfile

guard :rake, task: 'doc' do
  watch(/docs\/formal\/(.+)\.md/)
end

markdown.rb

require 'github/markdown'

module Dendrite

  class Markdown

    def self.generate
      Dir.glob('docs/formal/*.md').each do |f|
        file = File.open(f);

        contents = ''
        file.each { |line| contents << line }

        parsed_markdown = GitHub::Markdown.render_gfm(contents)

        new_file_name = f.gsub(/docs\/formal\//, '').gsub(/\.md/, '') + '.html'
        new_file = "docs/output/#{new_file_name}"

        File.open("./#{new_file}", 'w') { |html| html.write(parsed_markdown) }
      end
    end

  end

end

Rakefile

require 'rake'
require 'rainbow'
require './markdown.rb'

task :doc do
  begin
    Dendrite::Markdown.generate
    puts Rainbow("Generated documentation.").green
  rescue
    puts Rainbow("Failed to generate documentation!").red 
    raise
  end
end

namespace :doc do
  task :clean do
    Dir.glob('docs/output/*.html').each { |f| FileUtils.rm(f) }
  end
end