Konverter online gratis MERMAID ke PDF

PDF digunakan ketika diagram Mermaid harus dibagikan kepada orang yang tidak memiliki editor Mermaid, dicetak, atau disimpan dalam layout tetap. Mengonversi diagram sumber ke PDF akan merender flowchart atau mind map sebagai dokumen portabel, bukan membiarkannya sebagai kode diagram yang dapat diedit.

Apa itu format MERMAID

Mermaid adalah format diagram berbasis teks yang digunakan untuk flowchart, mind map, sequence diagram, entity-relationship diagram, timeline, dan dokumentasi visual terkait. File biasanya menggunakan .mmd atau .mermaid; kode Mermaid juga dapat muncul di dalam blok berpagar pada file Markdown.

File Mermaid berisi instruksi sumber seperti label node, koneksi, deklarasi layout, dan styling, bukan gambar jadi. Mermaid Live Editor, Mermaid CLI, ekstensi Visual Studio Code, Obsidian, dan sistem dokumentasi Markdown dapat membuat atau merender diagram ini.

Apa itu format PDF

PDF menyimpan diagram yang telah dirender bersama dimensi halaman, font, warna, dan informasi layout. Format ini cocok untuk pencetakan, lampiran email, dokumentasi, laporan teknis, dan salinan arsip karena penerima dapat melihatnya dengan software PDF standar tanpa menginstal Mermaid.

PDF biasanya merupakan presentation format, bukan format sumber: pengeditan diagram biasanya mengharuskan perubahan pada file Mermaid asli dan mengekspor PDF baru.

Cara mengonversi MERMAID ke PDF

Menggunakan Mermaid CLI

1. Instal Node.js jika belum terinstal.
2. Instal Mermaid CLI dengan npm install -g @mermaid-js/mermaid-cli.
3. Masukkan sumber diagram ke dalam file seperti flowchart.mmd. Pastikan file dimulai dengan sintaks Mermaid yang valid, misalnya flowchart TD.
4. Jalankan mmdc -i flowchart.mmd -o flowchart.pdf.
5. Buka flowchart.pdf dan periksa label, konektor, pemisah halaman, serta rendering font.

Untuk diagram yang harus muat dalam satu halaman PDF, gunakan mmdc -i flowchart.mmd -o flowchart.pdf --pdfFit. Perintah ini menggunakan renderer berbasis Chromium milik Mermaid, sehingga PDF berisi diagram yang telah dirender, bukan kode sumber asli.

Menggunakan 101convert.com

Anda dapat mengonversi file di 101convert.com secara gratis tanpa menginstal software. Unggah file Mermaid, pilih PDF sebagai format output, mulai konversi, lalu unduh dokumen yang dihasilkan. Opsi ini berguna ketika Node.js dan Mermaid CLI tidak tersedia.

Menggunakan editor Mermaid

Buka sumber di editor yang mendukung rendering Mermaid, lalu gunakan Export → PDF atau Print → Save as PDF pada browser. Pencetakan melalui browser merupakan alternatif; cara ini dapat menyertakan margin halaman, header, footer, atau penskalaan yang tidak ada dalam ekspor langsung Mermaid CLI.

Pertimbangan kualitas dan kompatibilitas

Diagram besar mungkin diperkecil hingga label sulit dibaca. Bagi sumber yang terlalu padat menjadi beberapa diagram, tingkatkan dimensi halaman melalui konfigurasi Mermaid CLI, atau ekspor PDF terpisah untuk bagian yang berbeda.

Output PDF bergantung pada versi Mermaid, tema rendering, font yang terinstal, serta ikon atau aset eksternal yang direferensikan. Gunakan versi Mermaid CLI yang sama untuk ekspor yang konsisten, dan pilih font umum atau sematkan font yang diperlukan melalui konfigurasi renderer ketika PDF akan dibuka di sistem lain.

Fitur interaktif, kemampuan pengeditan kode sumber, dan beberapa styling khusus browser tidak terbawa ke PDF. Simpan file .mmd asli bersama PDF ketika perubahan di masa mendatang mungkin diperlukan.