Markdown changes and fixes

Markdown fixes and improvements. Here's an example of MD generated with these changes in place:

https://github.com/CollectionFS/Meteor-cfs-gridfs/blob/master/api.md

There's some title/heading stuff at the top now, with a link to docmeteor repo, plus improved handling of bullet points, spacing, and horizontal rules.