Livemark

Um gerador de sites de documentação. Transforma uma pasta de ficheiros Markdown num site estático e rápido — realce de sintaxe através de Shiki, diagramas através de Mermaid, componentes interativos através de MDX, e um blogue e um changelog que funcionam sem configuração adicional.

As ferramentas de documentação costumam vir em dois tamanhos: pequenas demais para crescer, ou uma framework que quer dominar o projeto inteiro. O Livemark fica no meio — Markdown à entrada, um site à saída, com as saídas de emergência disponíveis quando uma página precisa mesmo de fazer algo invulgar. O resultado é estático, pelo que não há servidor para operar e pode ser alojado em qualquer sítio que sirva ficheiros.

Mantemo-lo, e usamo-lo. Vários dos projetos aqui listados documentam-se com ele, o que é uma forma fiável de descobrir onde estão as arestas por limar.