Muito bom e informativo, acho que o pessoal deveria falar mais de diagramação e estrutura do documento do que a sintaxe em si. Bom trabalho!

Acho que sempre eh uma boa prática considerar qual é o objetivo do projeto pra escrever o README. Talvez num repositório privado pra uma equipe pequena o readme seja menos descritivo e mais objetivo, tipo ter mais instruções de como rodar, testar e criar o ambiente de desenvolvimento; ou um projeto publico e opensource pode ter uma descrição sobre o que é o projeto com prints dele funcionando, algumas documentações básicas e etc. Nesses casos é bom ter um CONTRIBUTING.md pro pessoal q for contribuir saber cm rodar, testar e tals.

Inclusive, o github tem suporte a algumas coisinhas que descobri a um tempo atras, dá pra você criar admonitions (é assim que chama no Obsidian, ao menos), que são uns blocos com informação adicional. Por exemplo:

> [!INFO]
> Isso eh um texto adicional informativo.

Tem um repositorio meu que eu usei isso na prática, depois ve lá o resultado do README. E tem outro repositório super interessante de um pessoal que fez uns templates pra escrever o readme de algm projeto, valeu d+++ o esforço deles, ta aki ó: https://github.com/othneildrew/Best-README-Template