Darmowy konwerter online MERMAID do PDF

Format PDF jest używany, gdy diagram Mermaid musi zostać udostępniony osobom, które nie mają edytora Mermaid, wydrukowany lub zachowany w stałym układzie. Konwersja diagramu źródłowego do formatu PDF renderuje jego schemat blokowy lub mapę myśli jako dokument przenośny, zamiast pozostawiać go jako edytowalny kod diagramu.

Czym jest format MERMAID

Mermaid to tekstowy format diagramów używany do tworzenia schematów blokowych, map myśli, diagramów sekwencji, diagramów encji i związków, osi czasu oraz powiązanej dokumentacji wizualnej. Pliki zwykle mają rozszerzenie .mmd lub .mermaid; kod Mermaid może również znajdować się wewnątrz bloków z ogrodzeniem w plikach Markdown.

Plik Mermaid zawiera instrukcje źródłowe, takie jak etykiety węzłów, połączenia, deklaracje układu i style, a nie gotowy obraz. Mermaid Live Editor, Mermaid CLI, rozszerzenia Visual Studio Code, Obsidian oraz systemy dokumentacji Markdown mogą tworzyć lub renderować te diagramy.

Czym jest format PDF

PDF przechowuje wyrenderowany diagram wraz z wymiarami strony, czcionkami, kolorami i informacjami o układzie. Nadaje się do drukowania, załączników e-mail, dokumentacji, raportów technicznych i kopii archiwalnych, ponieważ odbiorcy mogą wyświetlać go za pomocą standardowego oprogramowania PDF bez instalowania Mermaid.

PDF jest zwykle formatem prezentacyjnym, a nie formatem źródłowym: edycja diagramu zazwyczaj wymaga zmiany oryginalnego pliku Mermaid i wyeksportowania nowego pliku PDF.

Jak konwertować MERMAID do PDF

Korzystanie z Mermaid CLI

1. Zainstaluj Node.js, jeśli nie jest jeszcze zainstalowany.
2. Zainstaluj Mermaid CLI za pomocą polecenia npm install -g @mermaid-js/mermaid-cli.
3. Umieść źródło diagramu w pliku, takim jak flowchart.mmd. Upewnij się, że zaczyna się ono od prawidłowej składni Mermaid, na przykład flowchart TD.
4. Uruchom polecenie mmdc -i flowchart.mmd -o flowchart.pdf.
5. Otwórz plik flowchart.pdf i sprawdź etykiety, łączniki, podziały stron oraz renderowanie czcionek.

Aby diagram mieścił się na jednej stronie PDF, użyj polecenia mmdc -i flowchart.mmd -o flowchart.pdf --pdfFit. Polecenie korzysta z renderera Mermaid opartego na Chromium, dlatego plik PDF zawiera wyrenderowany diagram, a nie oryginalny kod źródłowy.

Korzystanie z 101convert.com

Możesz bezpłatnie przekonwertować plik w serwisie 101convert.com bez instalowania oprogramowania. Prześlij plik Mermaid, wybierz PDF jako format wyjściowy, rozpocznij konwersję i pobierz wynikowy dokument. Ta opcja jest przydatna, gdy Node.js i Mermaid CLI są niedostępne.

Korzystanie z edytora Mermaid

Otwórz źródło w edytorze obsługującym renderowanie Mermaid, a następnie użyj opcji Export → PDF lub opcji Print → Save as PDF w przeglądarce. Drukowanie z poziomu przeglądarki jest rozwiązaniem awaryjnym; może uwzględniać marginesy stron, nagłówki, stopki lub skalowanie, których nie ma w bezpośrednim eksporcie z Mermaid CLI.

Kwestie dotyczące jakości i zgodności

Duże diagramy mogą zostać pomniejszone do momentu, w którym etykiety staną się trudne do odczytania. Podziel zatłoczone źródło na kilka diagramów, zwiększ wymiary strony za pomocą konfiguracji Mermaid CLI lub eksportuj osobne pliki PDF dla różnych sekcji.

Wynik PDF zależy od wersji Mermaid, motywu renderowania, zainstalowanych czcionek oraz wszelkich używanych ikon lub zewnętrznych zasobów. Aby uzyskać powtarzalne eksporty, korzystaj z tej samej wersji Mermaid CLI i wybierz popularną czcionkę lub osadź wymagane czcionki za pomocą konfiguracji renderera, jeśli plik PDF będzie otwierany w innych systemach.

Funkcje interaktywne, możliwość edycji kodu źródłowego oraz niektóre style specyficzne dla przeglądarki nie są przenoszone do formatu PDF. Zachowaj oryginalny plik .mmd razem z plikiem PDF, jeśli w przyszłości prawdopodobne są zmiany.