update readme
workaround markup mistakes in docs