Markdown realmente é maravilhoso. Eu tenho utilizado o Material MKDocs para gerar a documentação dos sistemas que eu desenvolvo. Inclusive estou fazendo um teste para também usar na parte de levantamento de requisitos.