cleaned up some examples, started with markdown