adds some examples to the readme file
fixes markdown of readme