Przejdź do treści

PlantUML do Mermaid

Konwertuj kod diagramu PlantUML na składnię Mermaid.

Wejście
Wynik

PlantUML do Mermaid

Wklej kod diagramu PlantUML i to narzędzie przepisze go na składnię Mermaid, gotową do wklejenia do pliku Markdown, GitHub README lub każdego renderera obsługującego Mermaid. Obsługuje diagramy sekwencji (uczestnicy, strzałki, paski aktywacji, notatki, pętle i bloki alt/else), diagramy klas (klasy, interfejsy, atrybuty, metody, dziedziczenie i asocjacje), diagramy stanów (przejścia, stany złożone, notatki) i proste schematy blokowe (start/stop, akcje i rozgałęzienia if/else).

Typ diagramu można wykryć automatycznie ze źródła lub ustawić ręcznie za pomocą opcji Typ diagramu, jeśli wykrycie jest błędne. Kierunek diagramu kontroluje, czy diagramy klas i stanów czytane są od góry do dołu, od lewej do prawej lub w innym kierunku, a schematy blokowe renderują się w ten sam sposób. Opcja Zachowaj notatki przenosi notatki z PlantUML jako notatki w Mermaid zamiast ich usuwać, a opcja Konwertuj nazwy ze spacjami na bezpieczne identyfikatory zmienia nazwy takie jak "Alice Liddell" na czysty identyfikator z oryginalnym tekstem zachowanym jako alias wyświetlania, dzięki czemu diagram nadal renderuje się prawidłowo.

Nie każda konstrukcja PlantUML ma bezpośredni odpowiednik w Mermaid. Zamiast po cichu usuwać to, czego nie może przetłumaczyć, konwerter zmienia nierozpoznany wiersz w komentarz Mermaid w tej samej pozycji, więc nic z oryginalnego źródła się nie znika — wyłącz opcję Zgłoś nieobsługiwane wiersze, aby usunąć te wiersze zamiast je komentować. Opcja Otocz wynik w blok kodu mermaid dodaje potrójne backticki, które oczekują rendery Markdown.

Konwersja przebiega całkowicie w Twojej przeglądarce przy użyciu czystego JavaScriptu — kod diagramu nigdy nie jest wysyłany nigdzie. Skopiuj wyjście Mermaid, pobierz je jako plik .txt lub wyślij bezpośrednio do wejścia innego narzędzia, aby kontynuować pracę.

Częste pytania

Które typy diagramów PlantUML są obsługiwane?
Diagramy sekwencji, klas, stanów i proste schematy blokowe (aktywności). Inne typy diagramów są konwertowane wierszami za wierszami gdzie składnia się nakłada, a wszystko nierozpoznane pozostaje jako komentarz.
Co się stanie z konstrukcją, którą narzędzie nie potrafi przekonwertować?
Zostanie wpisane do wyniku Mermaid jako komentarz zaczynający się od "%% unsupported:" abyś mógł to zobaczyć i naprawić ręcznie, chyba że wyłączysz Zgłoś nieobsługiwane wiersze, w którym to przypadku zostanie usunięty.
Jak działa automatyczne wykrywanie typu diagramu?
Narzędzie ocenia źródło względem wzorców składni typowych dla każdego typu diagramu — deklaracje uczestników i strzałki dla sekwencji, bloki klas i strzałki dziedziczenia dla klas itd. — i wybiera najlepsze dopasowanie. Przesłoń ją za pomocą opcji Typ diagramu, gdy wykrycie jest błędne.
Czy wynik dokładnie odpowiada składni Mermaid?
Następuje bieżąca składnia Mermaid dla konwertowanych konstrukcji. Bardzo niezwykłe formatowanie PlantUML lub rzadko używane słowa kluczowe mogą wymagać ręcznych dostosowań po konwersji.
Czy mój kod diagramu jest gdziekolwiek przesyłany?
Nie. Konwersja przebiega całkowicie w Twojej przeglądarce — Twój kod PlantUML nigdy nie opuszcza Twoje urządzenie.