Proper Markdown parsing

MSP-11356

# Verification Steps

## Before
- [x] `git checkout 27003af`
- [x] `bundle install`
- [x] `rake yard`
- [x] You should get an error about needing to install redcarpet
- [x] doc dir should not get created as you lack redcarpet

## After
- [x] `git checkout HEAD `
- [x] `bundle install`
- [x] `rake yard`
- [x] `open doc/index.html`
- [x] VERIFY Markdown link are rendered correctly:
![screen shot 2014-09-12 at 3 25 51 pm](https://cloud.githubusercontent.com/assets/2230482/4256703/04029362-3abb-11e4-886d-e16da1c38e8e.png)