Untuk menghubungkan dua subgraf Mermaid di Obsidian, beri setiap grup ID eksplisit dan hubungkan ID tersebut. Di Mac Anda, uji diagram minimal terlebih dahulu, lalu periksa apakah masalahnya terletak pada sintaks, arah tata letak, atau perbedaan renderer yang terpasang.

Panduan ini membahas panah yang terlihat di antara grup dalam satu diagram alur. Tujuannya adalah membuat koneksi yang dimaksud muncul, mengenali titik ujungnya, dan memilih alternatif praktis jika renderer tidak menghasilkan susunan yang diperlukan.

Mulai dengan koneksi minimal antara dua grup

Buat catatan sementara dan tempel seluruh blok berpagar di bawah ini. Metode yang didokumentasikan Obsidian untuk menambahkan diagram adalah blok kode dengan bahasa mermaid; tidak diperlukan file diagram terpisah. Sintaks pemformatan lanjutan

```mermaid
flowchart LR
    subgraph groupA [Group A]
        direction TB
        A1[Item A1] --> A2[Item A2]
    end
    subgraph groupB [Group B]
        direction TB
        B1[Item B1] --> B2[Item B2]
    end
    groupA --> groupB
```

Mermaid mendokumentasikan ID subgraf eksplisit serta sisi yang terhubung ke dan dari subgraf. Di sini, groupA dan groupB mengidentifikasi kontainer; teks dalam tanda kurung siku menjadi judulnya. Baris terakhir menghubungkan kontainer tersebut. Sintaks Diagram Alur

Beralih ke Tampilan baca untuk memeriksa hasilnya. Di macOS, pintasan yang didokumentasikan untuk beralih antara tampilan baca dan edit adalah Cmd+E. Anda juga dapat memilih Tampilan baca melalui kontrol tampilan di bilah status. Untuk mengedit sumber dengan cermat, pilih Mode sumber. Tampilan dan mode pengeditan

Gunakan tiga pemeriksaan penerimaan: kedua grup muncul, item di dalamnya muncul, dan sebuah panah menghubungkan batas kedua grup. Abaikan jarak dan gaya selama pemeriksaan pertama ini. Contoh-contoh ini mengikuti dokumentasi sintaks yang ditemukan; artikel ini belum merendernya di instalasi Obsidian lokal.

Jika contoh minimal berfungsi, simpan catatan itu sebagai referensi. Bandingkan diagram asli Anda dengannya secara bertahap: pertama deklarasi grup, lalu ID-nya, kemudian satu baris penghubung. Pulihkan konten tambahan hanya setelah koneksi dasar terlihat.

Periksa renderer yang digunakan versi Obsidian Anda

Catat versi aplikasi yang terpasang sebelum membandingkan hasil dengan contoh daring. Dokumentasi pembaruan Obsidian menyebutkan bahwa versi aplikasi dan penginstal tersedia di Pengaturan → Umum. Pilih Periksa pembaruan, lalu Luncurkan ulang jika pembaruan ditawarkan. Ikuti juga pemberitahuan penginstal yang terpisah. Perbarui Obsidian

Ada batas versi yang penting: catatan rilis Obsidian tanggal 22 Oktober 2026 menyebut Desktop 1.15.0 sebagai rilis akses awal dan mengatakan bahwa diagram menggunakan Pele, dengan kompatibilitas sintaks Mermaid 12.1.0. Catatan yang sama menyebutkan bahwa Obsidian tidak lagi menyertakan Mermaid dalam rilis tersebut. Anggap petunjuk yang mengasumsikan setiap instalasi Obsidian menyertakan Mermaid sebagai bergantung pada versi. Obsidian 1.15.0 Desktop (Akses awal)

Catatan rilis tersebut juga menghapus pengaturan Tampilkan diagram Mermaid di catatan pada versi 1.15.0. Jika instalasi Anda menampilkan pengaturan itu atau permintaan untuk mengaktifkannya, catat perbedaan tersebut alih-alih terus mencari kontrol yang dijelaskan untuk versi lain. Obsidian 1.15.0 Desktop (Akses awal)

Untuk pemecahan masalah, simpan catatan perbandingan singkat: versi aplikasi, tampilan edit atau baca, teks diagram yang persis, dan hasil yang diamati. Jelaskan hasilnya secara konkret—misalnya, “dua grup muncul, tetapi panah penghubung tidak terlihat.” Ini lebih berguna daripada hanya mencatat bahwa diagramnya bermasalah.

Tentukan apakah panah harus menghubungkan grup atau item

Pilih titik ujung sesuai dengan hal yang perlu disampaikan diagram. Untuk hubungan umum antara grup, mulailah dengan contoh kontainer. Untuk transisi tertentu antara item, gunakan alternatif lengkap berikut dan nilai secara terpisah.

```mermaid
flowchart LR
    subgraph groupA [Group A]
        A1[Item A1] --> A2[Item A2]
    end
    subgraph groupB [Group B]
        B1[Item B1] --> B2[Item B2]
    end
    A2 --> B1
```

Baris terakhir kini menghubungkan item bernama yang berada di sisi berbeda dari batas grup. Dokumentasi diagram alur Mermaid membedakan node, sisi, dan subgraf; gunakan ID titik ujung yang dimaksud secara konsisten. Sintaks Diagram Alur

Jika contoh kontainer gagal di renderer yang terpasang, tetapi contoh item berfungsi, contoh kedua dapat menjadi solusi praktis ketika hubungan antar-item menyampaikan maksud Anda. Pertahankan perbedaan itu di dalam diagram: jangan jadikan transisi item tertentu sebagai bukti bahwa kontainernya sendiri saling terhubung.

Saat menyesuaikan salah satu contoh, buat satu perubahan dalam satu waktu. Ganti judul yang terlihat terlebih dahulu, periksa hasilnya, lalu tambahkan item lainnya. Sisihkan gaya dan penyarangan untuk nanti. Urutan ini memberi tujuan yang jelas pada setiap perubahan dan memudahkan Anda mengenali perubahan pertama yang terkait dengan kegagalan.

Pahami alasan arah subgraf berubah

Mermaid mendokumentasikan keterbatasan tata letak: ketika sebuah node di dalam subgraf terhubung ke luar grupnya, arah subgraf itu sendiri diabaikan dan mengikuti arah induknya. Dokumentasinya membandingkan kondisi ini dengan koneksi ke kontainer. Arah dalam subgraf

Akibatnya, panah bisa benar meskipun susunannya berbeda dari yang Anda inginkan. Pada contoh pertama, periksa tumpukan internal dan panah antarkelompok secara terpisah. Pada contoh kedua, prioritaskan pemeriksaan titik ujung item sebelum menilai tata letaknya. Ingat perbedaan renderer yang dijelaskan di atas saat menafsirkan hasil mana pun.

Jika Anda memerlukan koneksi item tertentu sekaligus arah internal yang berbeda, perlakukan keduanya sebagai persyaratan penerimaan yang terpisah. Keterbatasan Mermaid yang didokumentasikan berarti Anda tidak dapat menjanjikan bahwa menambahkan pernyataan arah lokal akan memenuhi keduanya. Pilih koneksi yang menyampaikan hubungan secara akurat, lalu sederhanakan susunannya jika perlu.

Solusi praktisnya adalah mempertahankan satu arah keseluruhan dan memperpendek diagram sampai item yang terhubung mudah diikuti. Jika makna tingkat grup sudah cukup, kembali ke contoh pertama. Ini adalah pilihan editorial tentang hal yang disampaikan diagram, bukan jaminan mengenai posisi atau jalur panah yang persis.

Isolasi kegagalan sebelum menyusun ulang diagram

Gunakan urutan diagnosis ini untuk menentukan langkah berikutnya. Ini adalah alat bantu pengambilan keputusan yang diturunkan dari dokumentasi sintaks dan batas renderer, bukan daftar cacat yang telah dikonfirmasi.

Pengamatan Pemeriksaan berikutnya Hal yang perlu dicatat
Catatan menampilkan teks diagram secara harfiah Periksa pagar kode pembuka dan penutup, lalu beralih ke Tampilan baca Apakah blok dirender sama sekali
Contoh minimal menghasilkan kesalahan Bandingkan blok yang ditempel dengan contoh karakter demi karakter Teks kesalahan lengkap
Grup dirender, tetapi koneksinya tidak Uji alternatif lengkap antar-item secara terpisah Jenis titik ujung mana yang berhasil
Panah muncul, tetapi arah internal berubah Tinjau keterbatasan arah akibat node eksternal yang didokumentasikan Apakah masalah yang tersisa terkait konektivitas atau susunan
Contoh berfungsi sampai konten tambahan dipulihkan Batalkan penambahan terakhir dan ulangi satu perubahan itu Penambahan terkecil yang terkait dengan kegagalan
Teks yang sama berperilaku berbeda di tempat lain Bandingkan versi aplikasi, renderer, dan mode tampilan Lingkungan dan hasil yang persis

Untuk perbandingan sintaks secara independen, dokumentasi Obsidian merekomendasikan Mermaid Live Editor. Tempel isi diagram di sana tanpa pagar Markdown di sekelilingnya. Hasil yang berhasil dirender di browser berguna sebagai bahan perbandingan, tetapi tidak membuktikan bahwa perilakunya akan sama di versi Obsidian Anda. Sintaks pemformatan lanjutan

Jika hasilnya masih berbeda di Obsidian, ulangi pengujian minimal di vault sandbox desktop. Panduan pemecahan masalah resmi Obsidian menyebut Buka Bantuan > Vault Sandbox sebagai pemeriksaan desktop untuk mereproduksi masalah di luar pengaturan vault normal. Panduan tersebut juga menyarankan untuk memperbarui tema dan plugin komunitas serta memulai ulang sebelum diagnosis lebih lanjut. Tentang kategori laporan bug

Jika pengujian di sandbox berhasil, selidiki perbedaan di vault asli satu per satu. Jika di sana juga gagal, simpan contoh minimal, versi aplikasi dan penginstal, mode tampilan, serta hasil yang diamati secara persis. Sebelum melaporkannya, cari laporan serupa yang sudah ada di forum resmi, sesuai permintaan dalam panduan pelaporan Obsidian. Tentang kategori laporan bug

Akhiri dengan diagram terkecil yang menyampaikan hubungan yang diperlukan. Gunakan koneksi kontainer jika grup adalah titik ujung yang dimaksud; gunakan koneksi item jika transisinya melibatkan item tertentu. Setelah pilihan tersebut dirender dengan baik di versi Obsidian yang terpasang, pulihkan detail tambahan secara bertahap dan berhenti saat diagram tetap mudah dibaca.

Sumber