Przewodnik po składni mapy myśli Mermaid.js

Co to jest mapa myśli?

Mapa myślto wizualizacja oparta na hierarchicznej strukturze drzewa, używana do zapisywania, organizowania i strukturyzowania złożonych przepływów informacji, pomysłów wyłonionych w sesji mózgu, lub hierarchii projektów. W przeciwieństwie do schematów blokowych, które wyznaczają liniowe kroki procedury, mapy myśli przedstawiają połączenia między centralnym pojęciem a jego różnymi węzłami podrzędnymi, co czyni je idealnym narzędziem do planowania ogólnych tras rozwojowych, struktury rozkładu funkcji lub zarządzania wiedzą.

Za pomocą Mermaid.js, definiujesz strukturę hierarchiczną za pomocą standardowego wcięcia listy w Markdown. Silnik automatycznie obsługuje pozycjonowanie węzłów, oblicza wzrost drzewa i stosuje różne kształty węzłów w zależności od poziomu hierarchii, umożliwiając wizualizację setek połączonych ze sobą węzłów bez ręcznego dopasowania pikseli.

Podstawowy przewodnik składniowy: elementy i konstrukcje

Projektowanie poprawnej, produkcyjnej mapy myśli w Mermaid wymaga opanowania definicji węzła głównego, zagnieżdżania poziomów opartego na wcięciach oraz używania wizualnych tokenów dekoracyjnych.

1. Inicjowanie korzenia mapy myśli

Inicjujesz płótno mapy myśli w pierwszym wierszu, używając słowa kluczowego mindmapSłowo kluczowe. Struktura tworzona jest poprzez zdefiniowanie węzła głównego (środka Twojej mapy) i następnie zagnieżdżenie węzłów podrzędnych poniżej niego za pomocą standardowego wcięcia opartego na spacjach:

mindmap
  root((Centralny pojęciowy element))
    Węzeł poziomu 1
      Podwęzeł poziomu 2

2. Kontrolowanie geometrii węzła

Tak jak w schematach blokowych, możesz wprowadzić kontekst wizualny, otaczając tekst specjalnymi znakami nawiasów. Jest to bardzo zalecane do odróżniania głównych kategorii, zadań pomocniczych i działań do wykonania:

  • (Tekst) — Węzeł okrągły (domyślny).
  • ((Tekst)) — Węzeł podwójnie okrągły (zwykle przeznaczony dla korzenia).
  • [Tekst] — Węzeł kwadratowy.
  • )Tekst( — Węzeł wypukły/niesymetryczny.
  • {Tekst} — Węzeł sześciokątny/nawiasowy.

3. Integracja ikon i zewnętrznych formatów

Możesz poprawić czytelność węzłów, dodając wizualne ikony bezpośrednio w ciągu tekstowym, używając ::ikona(...) składni. Pozwala to szybko rozróżnić różne typy węzłów (np. osoby, oprogramowanie, sprzęt lub zewnętrzne interfejsy API) na pierwszy rzut oka:

mapa myśli
  korzeń((Architektura systemu))
    (Warstwa interfejsu użytkownika)
    ::ikona(fa fa-desktop)
      [Aplikacja internetowa]
    (Warstwa danych)
    ::ikona(fa fa-database)
      [Główna baza danych]

Najlepsze praktyki dla jasnych układów hierarchicznych

  • Zachowaj krótki tekst węzłów:Mapy myśli powinny służyć do szybkiego przeglądania. Zachowaj etykiety węzłów na poziomie trzech słów lub mniej, aby tekst nie rozciągał gałęzi drzewa poza szerokość ekranu.
  • Używaj spójnej geometrii:Utrzymuj ścisłą logikę kształtów na całym drzewie (np. używaj prostokątnych węzłów dla składników kodu, sześciokątnych dla punktów końcowych interfejsów API i zaokrąglonych dla infrastruktury fizycznej). Ta spójność ułatwia przetwarzanie mapy.
  • Ogranicz głębokość zagnieżdżenia: Staraj się, aby mapa była zagnieżdżona na głębokość nie większą niż cztery lub pięć poziomów. Jeśli gałąź wymaga głębszego zagnieżdżenia, rozważ jej wydzielenie do osobnej mapy myśli, aby rozmiar ogólnej płótna był zarządzalny.

Przykłady map myśli Mermaid.js z rzeczywistego świata i szablony

Przykład 1: Kategoryzacja cyklu życia rozwoju oprogramowania (SDLC)

Ten funkcjonalny szablon organizuje standardowe fazy cyklu życia rozwoju oprogramowania w drzewie kategoryzowanym, używając ikon do wizualnego wyróżnienia charakteru każdej grupy zadań.

mapa myśli
  korzeń((Fazy cyklu SDLC))
    (Planowanie)
    ::ikona(fa fa-tasks)
      [Wymagania]
      [Realizowalność]
    (Rozwój)
    ::ikona(fa fa-code)
      [Architektura]
      [Wdrożenie]
    (Jakość)
    ::ikona(fa fa-bug)
      [Testy jednostkowe]
      [Testy integracyjne]
    (Wdrożenie)
    ::ikona(fa fa-cloud)
      [Ścieżki CI/CD]
      [Monitorowanie]

Analiza składni: Używając korzeń węzła w centrum i wcięć dla poziomów, silnik generuje gałęzie symetrycznie. Składnia ::ikona(fa fa-...) wstawia znaki zgodne z FontAwesome, zamieniając abstrakcyjne fazy na wizualnie różne, łatwo czytelne węzły.

Przykład 2: Rozbicie funkcji mikroserwisów w firmie

Ten zaawansowany szablon rozdziela platformę e-commerce na zestawy funkcji technicznych, używając kształtów geometrycznych do rozróżnienia modułów infrastruktury i interfejsów skierowanych do klientów.

mapa myśli
  root((Platforma e-handlu))
    (Interfejs użytkownika)
      [Aplikacja mobilna]
      [Panel internetowy]
    (Warstwa usług)
      [Interfejs API uwierzytelniania]
      [Interfejs API zamówień]
    (Infrastruktura)
      ((Główny dostawca chmury))
        [Bufor Redis]
        [Instancja PostgreSQL]

Rozbicie składni: Ta mapa jawnie używa różnych kształtów do oznaczania logicznych składników systemu. To jasna hierarchia wizualna pozwala stakeholderom natychmiast rozróżnić usługi najwyższego poziomu od podstawowych elementów danych.

Przewijanie do góry