> Avoid using more complicated markup languages like HTML in the README file, however, because it should be convenient to read on a text-only terminal

And that's what README.md files from these days hardly can follow on Github.