Personally, I see the readme more as part of the git repository. IMO it is more important that it renders well on GitHub, instead of being part of the awestruct site. So I am fine with as it is.