some improvements to the git markdown