changed to markdown for rich formatting, links, descriptions etc
Merged changes by [johnrees]