readme formatting changes

Some markdown updates plus fixing an error where the `.py` was omitted from a command.