Converting to Markdown and adding some Mac install isntructions
small fixes to md documentation