Darmowy konwerter online MMD do PNG

Czym jest format MMD

W kontekście map myśli i schematów blokowych .mmd jest plikiem diagramu Mermaid w postaci zwykłego tekstu. Zawiera składnię Mermaid opisującą węzły, połączenia, etykiety, kierunki oraz typy diagramów, takie jak schematy blokowe, mapy myśli, diagramy sekwencji i diagramy klas.

Edytory Mermaid, systemy dokumentacji, repozytoria kodu i procesy tworzenia diagramów tworzą lub wykorzystują pliki MMD. Typowy plik zawiera kod źródłowy, taki jak flowchart TD; A[Start] --> B[Finish], a nie wcześniej wyrenderowane piksele. Plik można edytować za pomocą dowolnego edytora tekstu, ale do utworzenia obrazu wymaga renderera zgodnego z Mermaid.

Czym jest format PNG

PNG jest rastrowym formatem obrazu obsługiwanym przez przeglądarki internetowe, aplikacje biurowe, edytory obrazów, oprogramowanie do prezentacji i większość systemów operacyjnych. Nadaje się do diagramów, ponieważ wykorzystuje kompresję bezstratną, zachowuje ostre krawędzie w jednolitych kolorach i obsługuje przezroczystość.

Użyj PNG, gdy miejsce docelowe akceptuje obrazy, ale nie renderuje składni Mermaid, lub gdy potrzebujesz stałego obrazu do dokumentacji, wiadomości e-mail, prezentacji albo archiwizacji. PNG nie jest idealny do nieograniczonego skalowania; SVG jest zwykle lepszym rozwiązaniem, gdy diagram musi zachować ostrość grafiki wektorowej w dowolnym rozmiarze.

Jak przekonwertować MMD do PNG

Korzystanie z wbudowanego konwertera online

Możesz bezpłatnie przekonwertować plik w serwisie 101convert.com, bez instalowania oprogramowania. Prześlij plik .mmd, wybierz PNG jako format wyjściowy, jeśli pojawi się taki monit, rozpocznij konwersję i pobierz wyrenderowany obraz. Źródło musi zawierać prawidłową składnię Mermaid; plik zawierający niezwiązany tekst lub nieobsługiwaną składnię może nie zostać wyrenderowany.

Korzystanie z Mermaid CLI

Mermaid CLI jest najbardziej bezpośrednią metodą na komputerze lub w wierszu poleceń:

1. Zainstaluj Node.js, a następnie zainstaluj Mermaid CLI za pomocą polecenia npm install -g @mermaid-js/mermaid-cli.
2. Zapisz źródło Mermaid w pliku, na przykład diagram.mmd.
3. Wyrenderuj je za pomocą polecenia mmdc -i diagram.mmd -o diagram.png.

Polecenie odczytuje źródło Mermaid, renderuje je za pomocą silnika przeglądarki i zapisuje wynik PNG. Przydatne opcje obejmują -b transparent dla przezroczystego tła, -s 2 dla dwukrotnego skalowania, -w 2000 dla docelowej szerokości oraz -H 1200 dla docelowej wysokości. Na przykład:

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

W systemach, w których zależności Chromium są niedostępne, Mermaid CLI może wymagać pakietów systemu operacyjnego używanych przez jego silnik przeglądarki Puppeteer. Konfigurację renderowania można przekazać za pomocą -p puppeteer-config.json.

Ograniczenia jakości i zgodności

Wynik PNG zawiera wyłącznie wyrenderowany wygląd; pozycji węzłów, łączy, etykiet i składni Mermaid nie można edytować jako obiektów diagramu. Zachowaj oryginalny plik .mmd razem z PNG, jeśli w przyszłości prawdopodobne będą kolejne edycje.

Renderowanie może różnić się między wersjami Mermaid, ponieważ zmieniają się składnia diagramów, domyślne motywy, czcionki i algorytmy układu. Zainstaluj zgodną wersję Mermaid CLI i sprawdź niestandardowe czcionki na komputerze używanym do renderowania. Zwiększ wartości -s, -w lub -H, gdy małe etykiety wyglądają na rozmyte, ale unikaj powiększania PNG o niskiej rozdzielczości po konwersji.