Updated the css for pandoc
Re-organized README
Clarified some best-practices.