Darmowy konwerter online MERMAID do PNG

PNG jest przydatny, gdy diagram Mermaid musi zostać wstawiony do dokumentu, prezentacji, systemu śledzenia zgłoszeń lub archiwum opartego na obrazach, które nie potrafią renderować źródła Mermaid. Konwersja tworzy również stały wizualny zrzut do udostępniania, podczas gdy oryginalny plik Mermaid pozostaje edytowalny.

Czym jest format MERMAID

Plik MERMAID to definicja diagramu w postaci zwykłego tekstu, zwykle zapisywana z rozszerzeniem .mermaid lub .mmd. Zawiera składnię Mermaid dla schematów blokowych, map myśli, diagramów sekwencji, diagramów klas, diagramów stanów, diagramów encji-związków i innych uporządkowanych grafik, a nie zapisane piksele.

Pliki Mermaid są tworzone lub edytowane w Mermaid Live Editor, Mermaid CLI, Visual Studio Code z rozszerzeniami Mermaid oraz w aplikacjach takich jak Obsidian, GitLab i GitHub, które obsługują renderowanie Mermaid. Można się z nimi spotkać, gdy diagram jest przechowywany w repozytorium kodu źródłowego, dokumencie Markdown, aplikacji do notatek lub projekcie dokumentacji.

Czym jest format PNG

PNG to rastrowy format obrazu obsługiwany przez przeglądarki internetowe, oprogramowanie biurowe, narzędzia do prezentacji, przeglądarki obrazów i większość systemów dokumentów. Wykorzystuje kompresję bezstratną, lepiej niż JPEG zachowuje ostre linie w jednolitych kolorach i tekst oraz może przechowywać przezroczyste tła.

PNG jest odpowiedni, gdy odbiorca potrzebuje zwykłego obrazu zamiast składni Mermaid. Nie nadaje się idealnie do edytowania poszczególnych elementów diagramu ani do bardzo dużych diagramów, ponieważ powiększanie obrazu rastrowego może sprawić, że tekst i linie będą wyglądać na rozpikselowane.

Jak przekonwertować MERMAID do PNG

Korzystanie z 101convert online

1. Otwórz konwerter MERMAID-to-PNG na stronie 101convert.com.
2. Prześlij plik .mermaid lub .mmd.
3. Rozpocznij konwersję i pobierz wygenerowany plik .png.

Ta opcja nie wymaga instalowania oprogramowania i jest odpowiednia, gdy plik Mermaid nie zawiera poufnych informacji.

Korzystanie z Mermaid CLI

W przypadku powtarzalnych konwersji lokalnych zainstaluj Mermaid CLI za pomocą Node.js:

npm install -g @mermaid-js/mermaid-cli

Wyrenderuj plik źródłowy za pomocą:

mmdc -i diagram.mermaid -o diagram.png

Plik wejściowy może również używać rozszerzenia .mmd. Aby zwiększyć rozdzielczość rastrową, zastosuj współczynnik skalowania:

mmdc -i diagram.mmd -o diagram.png -s 2

Użyj koloru tła, gdy przezroczystość jest nieodpowiednia:

mmdc -i diagram.mmd -o diagram.png -b white

Mermaid CLI renderuje źródło za pomocą przeglądarki bez interfejsu graficznego. Jeśli podczas instalacji pojawi się problem z Chromium lub przeglądarką, przed ponownym uruchomieniem polecenia postępuj zgodnie z instrukcjami konfiguracji przeglądarki dla używanej wersji Mermaid CLI.

Korzystanie z edytora diagramów

Otwórz źródło w Mermaid Live Editor lub innym edytorze zgodnym z Mermaid, sprawdź, czy podgląd renderuje się prawidłowo, a następnie wybierz Export → PNG lub równoważne polecenie eksportu obrazu. Ustawienia eksportu mogą umożliwiać zastosowanie przezroczystego tła, wybór motywu lub zmianę skali.

Uwagi dotyczące jakości i zgodności

PNG odzwierciedla renderer Mermaid, wersję Mermaid, motyw, dostępne czcionki oraz wszelkie ustawienia inicjalizacji użyte podczas eksportu. Z tego powodu diagram może wyglądać inaczej po wyrenderowaniu przez inną aplikację lub inną wersję.

Zwiększ skalę eksportu w przypadku diagramów zawierających małe etykiety; zmiana szerokości PNG po eksporcie nie przywróci utraconych szczegółów. Zachowaj oryginalne źródło Mermaid razem z plikiem PNG, ponieważ PNG nie przechowuje węzłów, połączeń, reguł układu ani edytowalnego tekstu.

Jeśli miejsce docelowe obsługuje grafikę wektorową, SVG jest zwykle lepszym wyborem w przypadku dużych diagramów i późniejszego skalowania. Wybierz PNG, gdy aplikacja docelowa akceptuje wyłącznie obrazy rastrowe lub gdy wymagany jest obraz o stałym rozmiarze.