AsciiDoc is also supported by GitHub, I just use README.adoc instead of README.md.

The IntelliJ plugin is excellent.

And https://asciidoctor.org/docs/asciidoctor-diagram/ is amazing. I use PlantUML in it and love it.