Online konvertor MERMAID do PNG zdarma

PNG je užitečný, když je třeba vložit diagram Mermaid do dokumentu, prezentace, systému pro sledování problémů nebo archivu založeného na obrázcích, který nedokáže vykreslit zdrojový kód Mermaid. Převod diagramu také vytvoří neměnný vizuální snímek pro sdílení, zatímco původní soubor Mermaid zůstane upravitelný.

Co je formát MERMAID

Soubor MERMAID je definice diagramu v prostém textu, která se obvykle ukládá s příponou .mermaid nebo .mmd. Obsahuje syntaxi Mermaid pro vývojové diagramy, myšlenkové mapy, sekvenční diagramy, diagramy tříd, stavové diagramy, diagramy entit a vztahů a další strukturovanou grafiku, nikoli uložené pixely.

Soubory Mermaid se vytvářejí nebo upravují v Mermaid Live Editor, Mermaid CLI, Visual Studio Code s rozšířeními Mermaid a v aplikacích, jako jsou Obsidian, GitLab a GitHub, které podporují vykreslování Mermaid. Můžete se s nimi setkat, když je diagram uložen v repozitáři zdrojového kódu, dokumentu Markdown, aplikaci pro poznámky nebo projektu dokumentace.

Co je formát PNG

PNG je rastrový obrazový formát podporovaný webovými prohlížeči, kancelářským softwarem, prezentačními nástroji, prohlížeči obrázků a většinou systémů pro práci s dokumenty. Používá bezztrátovou kompresi, zachovává ostré jednobarevné čáry a text lépe než JPEG a může ukládat průhledná pozadí.

PNG je vhodný, když příjemce potřebuje běžný obrázek místo syntaxe Mermaid. Není ideální pro úpravu jednotlivých prvků diagramu ani pro mimořádně velké diagramy, protože při zvětšení rastrového obrázku mohou text a čáry působit pixelově.

Jak převést MERMAID na PNG

Pomocí online služby 101convert

1. Otevřete převodník MERMAID na PNG na webu 101convert.com.
2. Nahrajte soubor .mermaid nebo .mmd.
3. Spusťte převod a stáhněte vygenerovaný soubor .png.

Tato možnost nevyžaduje instalaci software a je vhodná, když soubor Mermaid neobsahuje citlivé informace.

Pomocí Mermaid CLI

Pro opakovatelné lokální převody nainstalujte Mermaid CLI pomocí Node.js:

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

Zdrojový soubor vykreslíte pomocí:

mmdc -i diagram.mermaid -o diagram.png

Vstupní soubor může používat také příponu .mmd. Chcete-li zvýšit rozlišení rastru, použijte faktor měřítka:

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

Pokud je průhlednost nevhodná, použijte barvu pozadí:

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

Mermaid CLI vykresluje zdroj pomocí bezhlavého prohlížeče. Pokud instalace nahlásí problém s Chromium nebo prohlížečem, před opětovným spuštěním příkazu postupujte podle pokynů k nastavení prohlížeče pro danou verzi Mermaid CLI.

Pomocí editoru diagramů

Otevřete zdroj v Mermaid Live Editor nebo jiném editoru kompatibilním s Mermaid, zkontrolujte, zda se náhled vykresluje správně, a poté zvolte Export → PNG nebo ekvivalentní příkaz pro export obrázku. Nastavení exportu může umožňovat průhledné pozadí, výběr motivu nebo úpravu měřítka.

Úvahy o kvalitě a kompatibilitě

PNG odráží renderer Mermaid, verzi Mermaid, motiv, dostupná písma a veškerá inicializační nastavení použitá během exportu. Diagram proto může při vykreslení jinou aplikací nebo verzí vypadat odlišně.

U diagramů obsahujících malé popisky zvyšte měřítko exportu; změna šířky PNG po exportu neobnoví ztracené detaily. Původní zdroj Mermaid uchovávejte společně s PNG, protože PNG nezachovává uzly, odkazy, pravidla rozvržení ani upravitelný text.

Pokud cílové prostředí podporuje vektorovou grafiku, SVG je obvykle vhodnější pro velké diagramy a pozdější změny velikosti. PNG zvolte, když cílová aplikace přijímá pouze rastrové obrázky nebo když je vyžadován obrázek s pevnou velikostí.