Mermaid wyprzedził PlantUML pod względem popularności

Mermaid wyprzedza PlantUML: konsekwencje dla analityków systemowych

Od grudnia 2025 roku Mermaid wyprzedził PlantUML pod względem popularności w Google Trends. draw.io usunął obsługę PlantUML z wersji online z powodu problemów z bezpieczeństwem, ograniczonego zestawu diagramów i architektury serwerowej. Mermaid działa po stronie klienta, obsługuje więcej typów diagramów. Microsoft zintegrował renderowanie Mermaid w edytorze Markdown w Visual Studio, GitHub dodał podgląd w Copilot Chat. Diagramy integrują się z dokumentacją, specyfikacjami i kodem.

Zmiany w podejściu do modelowania

Analitycy systemowi przechodzą od statycznych obrazów do modeli tekstowych. Mermaid pozwala osadzać diagramy w plikach Markdown obok wymagań, kontraktów API i reguł biznesowych. Sequence diagram umieszcza się przy scenariuszu integracji, state diagram — przy opisie cyklu życia, diagram ER — przy modelu domenowym.

To przyspiesza iteracje: AI generuje szkic Mermaid, zespół przegląda podgląd w IDE lub GitHub. Diagramy są wersjonowane jako tekst, aktualizowane cotygodniowo bez ręcznego rysowania.

Kluczowe zmiany w codziennej praktyce

• Integracja ze specyfikacjami: Diagramy żyją w jednym pliku z tekstem, nie jako oddzielne artefakty.
• Przyspieszenie discovery: Szybki szkic tekstem lub przez Copilot do uzgodnienia pomysłów.
• Obniżenie progu wejścia: Deweloperzy, QA i liderzy zespołów edytują schematy bez specjalistycznych narzędzi.

Visual Studio oferuje szablony dla API flow, entity relationships, task lifecycle. GitHub renderuje Mermaid w czatach Copilot.

Nowe umiejętności dla analityków

Modelowanie text-first wymaga opisywania struktur tekstem do automatycznej wizualizacji. Nacisk na sformułowania, mniej na interfejs graficzny.

Praca z AI: formułowanie promptów do generowania schematów z odpowiednim poziomem szczegółowości, granicami systemu, aktorami.

Szablonizacja: standardy nazewnictwa węzłów, strzałek, oznaczeń błędów, asynchroniczności, zewnętrznych systemów.

Co upraszcza się w pracy

Częste artefakty — sekwencje integracyjne, cykle życia, schematy kontekstowe, przeglądy onboardingowe — tworzone i aktualizowane szybciej. draw.io oferuje konwersję z PlantUML do Mermaid.

Migracja jest aktualna dla zmiennych diagramów w recenzjach i komunikacji.

Ograniczenia Mermaid

Nie zastępuje BPMN, Enterprise Architect do formalnego modelowania, certyfikacji. Ryzyko fałszywej wystarczalności: schematy AI wizualnie atrakcyjne, ale semantycznie słabe.

Nadmierna szczegółowość w dużych schematach prowadzi do szumu — potrzebne są warstwy modelowania.

Ewolucja roli analityka

Analityk staje się kuratorem żywej dokumentacji: utrzymuje wersjonowane schematy w docs-as-code. Ocena po zmniejszeniu nieporozumień, a nie po liczbie diagramów.

Rekomendacje wdrożeniowe

• Wybrać scenariusze: context diagram, sequence, state, ER-overview, component overview.
• Ustandaryzować nazewnictwo, szczegółowość, oznaczenia.
• Umieszczać diagramy obok user story, API spec, ADR.
• Używać AI do szkiców z analityczną weryfikacją.
• Migracja tylko zmiennych diagramów.

Co ważne

• Mermaid integruje się z GitHub, Visual Studio, draw.io — diagramy jako tekst w dev workflow.
• Zmniejsza dystans między wymaganiami a kodem, przyspiesza aktualizacje.
• Wymaga myślenia text-first i szablonów dla jakości.
• Nie do modelowania enterprise, ale idealny do żywej dokumentacji.
• draw.io migruje od PlantUML, przyspieszając adopcję.

— Editorial Team