Wykres Gantta
Planuj projekty na czytelnej osi czasu
Czym jest Wykres Gantta?
Wykres Gantta rozkłada zadania na kalendarzu z czasami trwania, zależnościami i kamieniami milowymi. To standard zarządzania projektami pokazujący, kto co robi, kiedy i co od czego zależy.
Wykresy Gantta pojawiają się na komitetach sterujących i w planach wydań, gdzie odbiorca oczekuje dat, a nie logiki. Zapisane tekstem zyskują nietypową przewagę: plan jest recenzowany w tym samym pull requeście co praca, którą opisuje. Ich słabością jest starzenie się — Gantt to migawka intencji, a nic w Mermaidzie nie powie Ci, że przestała ona odpowiadać rzeczywistości trzy tygodnie temu.
Żywy przykład
gantt
title Product Launch
dateFormat YYYY-MM-DD
section Design
Wireframes :a1, 2026-01-05, 10d
UI design :a2, after a1, 14d
section Build
Backend API :b1, 2026-01-12, 21d
Frontend :b2, after a2, 18d
section Launch
Beta testing :c1, after b2, 10d
Go live :milestone, after c1, 0dKiedy go używać
Częste błędy
dateFormat nie pasuje do dat
Przy dateFormat YYYY-MM-DD zadanie zaczynające się 05/01/2026 nie zostanie odrzucone — zostanie odczytane jako inna data, a wykres po cichu rozciągnie się na miesiące. Uzgodnij oba zapisy albo zadeklaruj dateFormat DD/MM/YYYY.
Dwukropek w nazwie zadania
Wszystko przed pierwszym dwukropkiem jest etykietą, więc Phase 1: discovery :a1, 2026-01-05, 7d rysuje zadanie „Phase 1” i po cichu gubi resztę nazwy. W nazwach zadań używaj zamiast tego myślnika.
Powtórzony identyfikator zadania
Identyfikatory muszą być unikalne. Gdy dwa zadania dzielą jeden, after wskaże ostatnią deklarację, więc zadanie zależne przeskoczy o tygodnie do przodu, i to bez żadnego błędu. Poprzedzaj identyfikatory skrótem sekcji — d1, b1, l1 — żeby pozostały rozróżnialne.
Podstawowa składnia
gantt
dateFormat YYYY-MM-DD
section Phase 1
Task A :a1, 2026-01-01, 7d
Task B :after a1, 5ddateFormat YYYY-MM-DD axisFormat %d/%mdateFormat mówi Mermaidowi, jak czytać wpisywane przez Ciebie daty; axisFormat decyduje, jak są drukowane wzdłuż osi. Oba ustawienia są niezależne i często się różnią.
Backend API :active, b1, 2026-01-12, 21dLinia zadania to etykieta, potem znaczniki, identyfikator, start i czas trwania. Znaczniki to done, active, crit i milestone; startem może być data albo after b1.
excludes weekends todayMarker stroke-width:4px,stroke:#e11excludes usuwa weekendy lub wskazane dni z kalendarza roboczego. todayMarker zmienia styl linii bieżącej daty, a todayMarker off ukrywa ją całkowicie.
section Launch Go live :milestone, m1, after c1, 0dSekcje grupują zadania w strumienie prac, każdy z własnym pasem koloru. Kamień milowy o zerowym czasie trwania renderuje się jako romb zamiast paska.
Pytania o ten diagram
Czy zadania mogą zależeć od siebie nawzajem?
Tak — użyj „after taskId”, aby łączyć zadania w łańcuchy, oraz kamieni milowych do oznaczania kluczowych dat. Sekcje grupują zadania według obszaru lub zespołu.
Czy tekstowy Gantt jest lepszy od narzędzia do zarządzania projektami?
Do komunikacji — tak: żyje w Twojej dokumentacji, wersjonuje się z gitem i aktualizuje w sekundy. Do zarządzania zasobami połącz go ze swoim narzędziem PM.
Jak udostępnić wykres Gantta osobom, które nie używają Mermaida?
Eksportuj PNG na slajdy i do maila, SVG do wszystkiego, co będzie powiększane, albo opublikuj diagram jako stronę publiczną i wyślij link — link po aktualizacji planu wciąż pokazuje bieżącą wersję.
Czy wykres Gantta w Mermaid pokazuje przypisania i postęp prac?
Nie. Nie ma kolumny zasobów ani paska postępu; jedyną informacją o statusie są znaczniki done, active i crit przy zadaniu. Planowanie obciążeń zostaw narzędziu do zarządzania projektami, a wykres wykorzystaj do komunikacji.
Czy Mermaid rysuje strzałki między zadaniami zależnymi?
Nie. Zapis after b1 ustala datę startu zadania, ale nie rysuje żadnej strzałki zależności, więc powiązanie pozostaje dla czytelnika niewidoczne. Napisz o nim w nazwie zadania albo użyj schematu blokowego, gdy komunikatem jest sam graf zależności.
Jak zaznaczyć na wykresie dzisiejszą datę?
Mermaid domyślnie rysuje znacznik w bieżącej dacie, pobranej z zegara tego, kto renderuje diagram. todayMarker stroke-width:4px,stroke:#e11 zmienia jego styl, a todayMarker off go usuwa — przydatne, gdy wykres jest szablonem wielokrotnego użytku, a nie żywym planem.
Wykres Gantta czy inny typ diagramu?
Wykres Gantta czy oś czasu?
Gantt służy pracy, która się jeszcze nie wydarzyła: czasom trwania, zależnościom, ścieżce krytycznej. Oś czasu służy wydarzeniom, które mają datę, ale nie mają czasu trwania — wydaniom, incydentom, historii firmy. Jeśli nic na Twojej liście nie ma długości, potrzebujesz osi czasu.
Wykres Gantta czy schemat blokowy?
Oba opisują plan. Schemat blokowy zachowuje rozgałęzienia — co się stanie, jeśli audyt wypadnie źle — i ignoruje kalendarz; Gantt zachowuje kalendarz i spłaszcza wszystkie gałęzie do jednej ścieżki nominalnej. Komitety chcą Gantta, zespoły dostarczające często potrzebują obu.
Stwórz swój Wykres Gantta już teraz
Opisz go naturalnym językiem — AI napisze kod Mermaid za Ciebie.
Otwórz Mermaid Studio