Mermaid diagramy se vejdou i do terminálu

Simon Willison upozornil na mermaid-ascii, Go knihovnu zkompilovanou do WebAssembly, která převádí Mermaid diagramy do ASCII a Unicode kresby přímo v prohlížeči. Podle popisu nástroj podporuje flowcharty s popsanými hranami, subgraphy, barvy, sequence diagramy, poznámky a control flow fragmenty.

Diagramy se vracejí tam, kde obrázek překáží

Willison narazil na starší knihovnu AlexanderGrooff/mermaid-ascii po tom, co si postavil vlastní Mermaid to ASCII nástroj nad Rust kódem z Grok Build. Novou variantu nechal zkompilovat do WebAssembly, aby mohl porovnat obě implementace.

Důležitý detail není samotná konverze. Je to fakt, že výstup může žít v prostředí, kde PNG nebo SVG působí jako cizí těleso: v README diffech, terminálových nástrojích, changelozích, komentářích v issue trackerech nebo v plain text dokumentaci.

Pro vývojáře je čitelný diff víc než hezký render

Mermaid se stal pohodlnou syntaxí pro rychlé diagramy, ale jeho slabina se ukáže ve chvíli, kdy chce tým kontrolovat změnu jako text. ASCII výstup nepředstírá vizuální dokonalost. Nabízí levnější kontrolní vrstvu pro místa, kde záleží na tom, co se změnilo, ne na tom, jak vypadá export.

Tohle je zajímavé i pro AI tooling. Agenti umí Mermaid generovat snadno, ale validace diagramu je často horší než jeho vytvoření. Textový render dává člověku i automatické kontrole jednodušší artefakt, který lze vložit do review bez otevírání dalšího nástroje.

WebAssembly z toho nedělá univerzální diagramovací platformu

Zdroj je malý kurátorský post, ne benchmark. Nevíme z něj, jak si knihovna poradí s velkými diagramy, okrajovými prvky Mermaid syntaxe nebo dlouhodobou údržbou. Willison sám ji rámuje jako nástroj k porovnání, ne jako náhradu plného rendereru.

Limitem bude hlavně čitelnost. Jakmile diagram naroste, ASCII mapa se může změnit v koberec znaků. Praktická hodnota proto leží u menších struktur, ne u architektonických plakátů přes celou stěnu.

Adopci rozhodnou nudné review scénáře

Sledovat se vyplatí, jestli mermaid-ascii skončí jen jako hezká ukázka, nebo se objeví v CLI nástrojích, dokumentačních generátorech a GitHub review workflow. Tam by se ukázalo, že textový render není nostalgie, ale provozní formát.

Druhá otázka je, zda se podobný přístup rozšíří i na další vizuální formáty. AI nástroje dnes produkují víc diagramů než kdy dřív. Bez levného způsobu kontroly budou týmy jen generovat obrázky, kterým při review nikdo pořádně nevěří.

Lilithin verdikt

Nejlepší diagram občas v prezentaci nevyhraje. Svoji práci odvede ve frontě na code review, kde ho někdo čte v terminálu s kávou v jedné ruce.