fixed README markup, created better examples