Das Versprechen
Beautiful-mermaid ist eine TypeScript-Bibliothek ohne Abhängigkeiten, die Luki Labs im Januar 2026 veröffentlicht hat. Sie verarbeitet Mermaid-Syntax ohne DOM. Sie schlägt eine Brücke zu terminalbasierten Oberflächen und KI-gestützter Entwicklung, weil sie sowohl professionelle SVGs als auch detailgetreue ASCII-Art ausgibt (Quelle: GitHub).
Unter der Haube
Das Projekt ist eine direkte TypeScript-Portierung und Erweiterung der Go-Implementierung „mermaid-ascii“ von Alexander Grooff (Quelle: GitHub README). Durch den Abschied von Go lässt sich die Bibliothek leichter in Node.js-Backends und LLM-zentrierte Workflows einbinden, die textbasierte Visualisierungen brauchen.
Der Renderer unterstützt derzeit fünf Diagrammtypen: Flussdiagramme, Zustands-, Sequenz-, Klassen- und ER-Diagramme (Quelle: Ecosystem Startup). Bemerkenswert ist, dass die Entwickler die ursprüngliche ASCII-Engine um Sequenz- und Klassendiagramme erweitert haben, die es im ursprünglichen Go-Code nicht gab (Quelle: GitHub-Commit 2026).
Die Einbindung in moderne Entwicklungsumgebungen erfolgt über 15 integrierte Themes, die vollständig mit den Theme-Spezifikationen von Shiki und VS Code kompatibel sind (Quelle: Projektdokumentation). So bleiben Dokumentation und Terminal-Oberflächen visuell einheitlich, ohne CSS von Hand zu überschreiben.
Der Wechsel von Go zu TypeScript hat allerdings bestimmte Regressionen mit sich gebracht. Frühe Nutzer haben Rendering-Fehler in der Syntax stateDiagram-v2 gefunden: Start- und Endknoten werden in der Ausgabe nicht korrekt dargestellt (Quelle: HN-Kommentar).
Noch wissen wir nicht, ob die Bibliothek die erweiterten Syntaxfunktionen von Mermaid 2026 unterstützen wird, etwa Quadrantendiagramme oder Mindmaps.
Unsere Einschätzung
Beautiful-mermaid ist eine pragmatische Wahl für Backend-Entwickler, die Diagramme in CLI-Tools oder LLM-Prompts erzeugen müssen, ohne den Aufwand von Puppeteer oder einem Browser. Für die meisten Standarddiagramme funktioniert das Tool, doch die aktuellen Fehler bei Zustandsdiagrammen machen es ein wenig zu einem Kompass ohne Norden. Nutzen Sie es für automatisierte Berichte im Terminal, halten Sie es aber aus Ihrer kritischen Dokumentations-Pipeline heraus, bis die Rendering-Fehler bei stateDiagram-v2 behoben sind.