cara uma dica muito boa é apenas usar o Docusaurus, eu tô usando ele no site que tô criando o harukadev.com e to amando ❤️, ele permite tanto criar um site legal, quanto um blog ou uma documentação.

com certeza vc já viu algum site usando o Docusaurus, ele permite criar páginas usando react ou markdown, também tem suporte para tradução e outras coisas legais

se tú configurar certinho tem como fazer ele integrar com o github actions e o github pages