Uma possível solução é Docutils . Seu formato "structureduredtext" é mais legível que outras opções e possui suporte embutido para tabelas. Os mantenedores parecem estar fazendo um bom trabalho documentando e mantendo o pacote, o que deve mantê-lo relativamente estável.