update readme and markdown generation