Online konvertor MERMAID do PDF zdarma

PDF se používá, když je třeba diagram Mermaid sdílet s lidmi, kteří nemají editor Mermaid, vytisknout jej nebo zachovat v pevném rozvržení. Převod zdrojového diagramu do PDF vykreslí jeho vývojový diagram nebo myšlenkovou mapu jako přenosný dokument, místo aby zůstal ve formě upravitelného kódu diagramu.

Co je formát MERMAID

Mermaid je textový formát diagramů používaný pro vývojové diagramy, myšlenkové mapy, sekvenční diagramy, diagramy vztahů mezi entitami, časové osy a související vizuální dokumentaci. Soubory běžně používají příponu .mmd nebo .mermaid; kód Mermaid se může nacházet také uvnitř bloků s ohraničením v souborech Markdown.

Soubor Mermaid obsahuje zdrojové instrukce, jako jsou popisky uzlů, propojení, deklarace rozvržení a styly, nikoli hotový obrázek. Mermaid Live Editor, Mermaid CLI, rozšíření Visual Studio Code, Obsidian a systémy dokumentace Markdown mohou tyto diagramy vytvářet nebo vykreslovat.

Co je formát PDF

PDF ukládá vykreslený diagram společně s rozměry stránky, písmy, barvami a informacemi o rozvržení. Je vhodný pro tisk, e-mailové přílohy, dokumentaci, technické zprávy a archivní kopie, protože příjemci jej mohou zobrazit pomocí standardního softwaru pro PDF bez instalace Mermaid.

PDF je obvykle prezentační formát, nikoli zdrojový formát: úprava diagramu obvykle vyžaduje změnu původního souboru Mermaid a export nového PDF.

Jak převést MERMAID do PDF

Pomocí Mermaid CLI

1. Nainstalujte Node.js, pokud ještě není nainstalovaný.
2. Nainstalujte Mermaid CLI pomocí příkazu npm install -g @mermaid-js/mermaid-cli.
3. Uložte zdroj diagramu do souboru, například flowchart.mmd. Ujistěte se, že začíná platnou syntaxí Mermaid, například flowchart TD.
4. Spusťte příkaz mmdc -i flowchart.mmd -o flowchart.pdf.
5. Otevřete flowchart.pdf a zkontrolujte popisky, konektory, zalomení stránek a vykreslení písem.

Pokud se má diagram vejít na jednu stránku PDF, použijte mmdc -i flowchart.mmd -o flowchart.pdf --pdfFit. Příkaz používá vykreslovač Mermaid založený na Chromium, takže PDF obsahuje vykreslený diagram, nikoli původní zdrojový kód.

Pomocí 101convert.com

Soubor můžete zdarma převést na webu 101convert.com bez instalace softwaru. Nahrajte soubor Mermaid, vyberte PDF jako výstupní formát, spusťte převod a stáhněte výsledný dokument. Tato možnost je užitečná, když nejsou k dispozici Node.js a Mermaid CLI.

Pomocí editoru Mermaid

Otevřete zdroj v editoru s podporou vykreslování Mermaid a poté použijte Export → PDF nebo Print → Save as PDF v prohlížeči. Tisk z prohlížeče je záložní možnost; může obsahovat okraje stránky, záhlaví, zápatí nebo měřítko, které nejsou součástí přímého exportu z Mermaid CLI.

Úvahy o kvalitě a kompatibilitě

Velké diagramy mohou být zmenšeny natolik, že bude obtížné číst popisky. Rozdělte přeplněný zdroj do několika diagramů, zvětšete rozměry stránky pomocí konfigurace Mermaid CLI nebo exportujte samostatné soubory PDF pro různé části.

Výstup PDF závisí na verzi Mermaid, motivu vykreslování, nainstalovaných písmech a případných odkazovaných ikonách nebo externích prostředcích. Pro opakovatelné exporty používejte stejnou verzi Mermaid CLI a zvolte běžné písmo nebo pomocí konfigurace vykreslovače vložte požadovaná písma, pokud bude PDF otevíráno v jiných systémech.

Interaktivní funkce, upravitelnost zdrojového kódu a některé styly specifické pro prohlížeč se do PDF nepřenášejí. Pokud se očekávají budoucí změny, uchovávejte původní soubor .mmd společně s PDF.