O pitch
Beautiful-mermaid é uma biblioteca TypeScript sem dependências, lançada em janeiro de 2026 pela Luki Labs, para processar a sintaxe Mermaid sem DOM. Ela serve de ponte para interfaces de terminal e para o desenvolvimento assistido por IA, gerando tanto SVGs profissionais quanto arte ASCII de alta fidelidade (fonte: GitHub).
Por dentro
O projeto é um port direto para TypeScript, com extensões, da implementação em Go “mermaid-ascii” de Alexander Grooff (fonte: README do GitHub). Ao deixar o Go, a biblioteca fica mais fácil de integrar em ambientes de backend Node.js e em workflows centrados em LLMs que exigem visualizações em texto.
O renderizador hoje suporta cinco tipos específicos de diagrama: fluxogramas e diagramas de estado, de sequência, de classe e ER (fonte: Ecosystem Startup). Vale notar que os desenvolvedores estenderam o motor ASCII original para incluir suporte a diagramas de sequência e de classe, que não existiam no código-fonte original em Go (fonte: commit no GitHub, 2026).
A integração com ambientes de desenvolvimento modernos é feita por meio de 15 temas nativos, totalmente compatíveis com as especificações de tema do Shiki e do VS Code (fonte: documentação do projeto). Isso garante consistência visual entre a documentação e as interfaces de terminal sem sobrescrever CSS manualmente.
No entanto, a migração de Go para TypeScript introduziu regressões específicas. Os primeiros usuários identificaram bugs de renderização na sintaxe stateDiagram-v2, em particular nós de início e de fim que não são renderizados corretamente na saída (fonte: comentário no HN).
Ainda não sabemos se a biblioteca vai suportar os recursos mais amplos da sintaxe Mermaid de 2026, como gráficos de quadrante ou mapas mentais.
Nossa opinião
Beautiful-mermaid é uma escolha pragmática para engenheiros de backend que precisam gerar diagramas dentro de ferramentas de CLI ou de prompts de LLM sem o peso do Puppeteer ou de um navegador. É uma ferramenta funcional para a maioria dos diagramas padrão, embora os bugs atuais nos diagramas de estado a tornem um pouco como uma bússola sem o Norte. Use-a para relatórios automatizados no terminal, mas mantenha-a fora do seu pipeline de documentação crítica até que os problemas de renderização do stateDiagram-v2 sejam resolvidos.