The ideal README file looks good in a terminal, but also has a bit of markup to make it look prettier on a code forge (e.g. Sourcehut, Codeberg). I believe markdown provides too much formatting (markdown links are particuarly ugly), and I just realized that README files are a perfect application for gemtext: https://gemini.circumlunar.space/docs/gemtext.gmi