Online konvertor MERMAID do SVG zdarma

Co je formát MERMAID

V kontextu myšlenkových map a vývojových diagramů je soubor MERMAID zdrojový soubor v prostém textu obsahující syntaxi Mermaid, obvykle uložený s příponou .mmd nebo .mermaid. Zdroj popisuje vývojové diagramy, sekvenční diagramy, třídní diagramy, stavové diagramy, entity-relační diagramy a myšlenkové mapy, místo aby ukládal hotový obrázek.

Soubory Mermaid se vytvářejí nebo upravují v Mermaid Live Editoru, ve Visual Studio Code s rozšířením Mermaid, v Obsidianu a v dokumentačních systémech, které podporují bloky Mermaid. Po otevření souboru v textovém editoru se zobrazí deklarace jako flowchart TD nebo mindmap; tyto deklarace musí být vykresleny enginem kompatibilním s Mermaid.

Co je formát SVG

SVG neboli Scalable Vector Graphics je obrazový formát založený na XML, který ukládá cesty, tvary a text. Prohlížeče, nástroje pro dokumentaci, vektorové editory a mnoho publikačních aplikací jej dokážou zobrazit bez runtime Mermaid.

SVG zůstává ostré i při zvětšení, obecně se škáluje lépe než rastrový snímek obrazovky a lze jej stylovat nebo upravovat v aplikacích, jako je Inkscape. Exportovaný soubor je vykreslený diagram, nikoli původní zdroj Mermaid, takže pozdější změna struktury diagramu je snazší v souboru .mmd.

Jak převést MERMAID na SVG

Pomocí Mermaid CLI

Mermaid CLI je nejpřímější metoda pro desktop nebo příkazový řádek a vyžaduje Node.js. Renderer nainstalujete pomocí:

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

Uložte zdroj jako diagram.mmd a poté jej vykreslete pomocí:

mmdc -i diagram.mmd -o diagram.svg

Volba -i určuje zdroj Mermaid a -o určuje výstup SVG. U diagramu, který používá vlastní motiv nebo konfigurační soubor, jej předejte pomocí:

mmdc -i diagram.mmd -o diagram.svg -c mermaid-config.json

Vykreslovat můžete také přímo pomocí npx bez globální instalace:

npx -p @mermaid-js/mermaid-cli mmdc -i diagram.mmd -o diagram.svg

Pomocí Mermaid Live Editoru

Otevřete zdroj v Mermaid Live Editoru, zkontrolujte vykreslený náhled, zda neobsahuje syntaktické chyby, a poté použijte Actions → Export Diagram → SVG nebo odpovídající ovládací prvek pro export SVG. Stažený soubor uložte s příponou .svg. Tato metoda je vhodná, když nelze nainstalovat Node.js, závisí však na podporované verzi Mermaid v editoru a dostupných funkcích diagramů.

Pomocí integrovaného online konvertoru

Soubor můžete zdarma převést na webu 101convert.com bez instalace softwaru: nahrajte soubor .mmd nebo .mermaid, zvolte SVG jako výstupní formát, spusťte převod a stáhněte výsledný soubor .svg.

Úvahy o kvalitě a kompatibilitě

Chyby při převodu obvykle vznikají kvůli nepodporované syntaxi Mermaid, chybějícím závislostem diagramu nebo neplatnému odsazení v konstrukcích, jako jsou myšlenkové mapy. Před exportem zdroj vykreslete a zkontrolujte SVG v zamýšlené velikosti zobrazení.

Výstup SVG může záviset na dostupných fontech, vykreslování prohlížeče, verzi Mermaid a nastavení motivu. Pokud záleží na přesném vzhledu, použijte běžný font nebo po exportu převeďte text na cesty ve vektorovém editoru; převod textu na cesty ztěžuje jeho pozdější úpravy.

Některé aplikace pro práci s SVG omezují vložené styly, skripty, hypertextové odkazy nebo cizí XML prvky. Pro maximální kompatibilitu použijte prosté statické SVG a odstraňte interaktivní funkce závislé na JavaScriptu. Původní soubor Mermaid uchovávejte spolu se SVG, aby diagram zůstal strukturálně upravitelný.