Diagramy Mermaid znów mieszczą się w terminalu

Simon Willison zwrócił uwagę na mermaid-ascii, bibliotekę w Go skompilowaną do WebAssembly, która zamienia diagramy Mermaid na ASCII i Unicode box drawing bezpośrednio w przeglądarce. Opis narzędzia mówi o obsłudze flowchartów z opisanymi krawędziami, subgraphów, kolorów, sequence diagrams, notatek i fragmentów control flow.

Diagramy wracają tam, gdzie obrazek przeszkadza

Willison trafił na starszą bibliotekę AlexanderGrooff/mermaid-ascii po tym, jak zbudował własne narzędzie Mermaid to ASCII na bazie kodu w Rust z Grok Build. Tę wersję również skompilował do WebAssembly, żeby porównać oba podejścia.

Najważniejsza nie jest sama konwersja. Ważne jest to, że wynik może żyć tam, gdzie PNG albo SVG są niewygodne: w diffach README, narzędziach terminalowych, changelogach, komentarzach w issue trackerach i dokumentacji plain text.

Dla programistów czytelny diff bywa ważniejszy niż ładny render

Mermaid stał się wygodną składnią do szybkich diagramów, ale jego słabość widać wtedy, gdy zespół chce przejrzeć zmianę jak tekst. ASCII nie udaje wizualnej perfekcji. Daje tańszą warstwę kontroli w miejscach, gdzie liczy się zmiana, a nie eksportowany obrazek.

To ma znaczenie także dla AI tooling. Agenci łatwo generują Mermaid, ale sprawdzenie diagramu bywa trudniejsze niż jego stworzenie. Tekstowy render daje ludziom i automatycznym kontrolom artefakt, który można włożyć do review bez otwierania kolejnego narzędzia.

WebAssembly nie robi z tego uniwersalnej platformy do diagramów

Źródło jest krótkim wpisem kuratorskim, nie benchmarkiem. Nie wiemy z niego, jak biblioteka radzi sobie z dużymi diagramami, brzegowymi elementami składni Mermaid ani długoterminowym utrzymaniem. Willison pokazuje ją jako narzędzie do porównania, nie zastępstwo pełnego renderera.

Ograniczeniem będzie przede wszystkim czytelność. Gdy diagram urośnie, mapa ASCII może zmienić się w dywan znaków. Praktyczna wartość leży więc przy mniejszych strukturach, nie przy architektonicznych plakatach na całą ścianę.

O adopcji zdecydują zwykłe scenariusze review

Warto obserwować, czy mermaid-ascii zostanie ciekawostką, czy trafi do CLI, generatorów dokumentacji i workflow na GitHubie. Tam okaże się, czy tekstowy render jest nostalgią, czy formatem operacyjnym.

Drugie pytanie brzmi, czy podobne podejście obejmie inne formaty wizualne. Narzędzia AI produkują dziś więcej diagramów niż wcześniej. Bez taniego sposobu kontroli zespoły będą tylko generować obrazki, którym podczas review nikt do końca nie ufa.

Werdykt Lilith

Najlepszy diagram czasem nie jest tym, który błyszczy na slajdzie. To ten, który przetrwa kolejkę code review, czytany w terminalu przez kogoś z kawą w jednej ręce.