Obsidian में दो Mermaid सबग्राफ़ को जोड़ने के लिए, प्रत्येक समूह को एक स्पष्ट ID दें और उन IDs को जोड़ें। अपने Mac पर पहले एक न्यूनतम डायग्राम आज़माएँ, फिर जाँचें कि समस्या सिंटैक्स, लेआउट की दिशा या इंस्टॉल किए गए रेंडरर में अंतर की है।

यह गाइड एक फ़्लोचार्ट में समूहों के बीच दिखाई देने वाले तीरों के बारे में है। उद्देश्य है कि इच्छित कनेक्शन दिखाई दे, उसके सिरों की पहचान हो और जब रेंडरर आवश्यक व्यवस्था न बनाए, तो कोई व्यावहारिक विकल्प चुना जा सके।

पहले दो समूहों के बीच न्यूनतम कनेक्शन आज़माएँ

एक अस्थायी नोट बनाएँ और नीचे दिया गया पूरा फ़ेंस्ड ब्लॉक पेस्ट करें। Obsidian के दस्तावेज़ों में डायग्राम जोड़ने का तरीका यह है कि mermaid भाषा वाला कोड ब्लॉक इस्तेमाल किया जाए; अलग डायग्राम फ़ाइल की ज़रूरत नहीं है। उन्नत फ़ॉर्मैटिंग सिंटैक्स

```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 के दस्तावेज़ों में स्पष्ट सबग्राफ़ IDs और सबग्राफ़ से आने-जाने वाले एज दिए गए हैं। यहाँ groupA और groupB कंटेनरों की पहचान करते हैं; वर्गाकार कोष्ठकों में दिया गया टेक्स्ट उनके शीर्षक बताता है। आख़िरी पंक्ति कंटेनरों को जोड़ती है। फ़्लोचार्ट सिंटैक्स

नतीजा देखने के लिए Reading view पर जाएँ। macOS पर रीडिंग और एडिटिंग व्यू के बीच टॉगल करने का दस्तावेज़ित शॉर्टकट Cmd+E है। आप स्टेटस बार के व्यू कंट्रोल से भी Reading view चुन सकते हैं। स्रोत को सटीक रूप से संपादित करने के लिए Source mode चुनें। व्यू और एडिटिंग मोड

स्वीकृति के लिए तीन चीज़ें जाँचें: दोनों समूह दिखाई दें, उनके अंदर की चीज़ें दिखाई दें और दोनों समूहों की सीमाओं को जोड़ने वाला तीर दिखे। इस शुरुआती जाँच में दूरी और स्टाइलिंग पर ध्यान न दें। ये उदाहरण उपलब्ध सिंटैक्स दस्तावेज़ों के अनुसार हैं; इस लेख के लिए इन्हें किसी स्थानीय Obsidian इंस्टॉलेशन में रेंडर करके नहीं देखा गया है।

अगर न्यूनतम उदाहरण काम करता है, तो उस नोट को संदर्भ के लिए रखें। अपने मूल डायग्राम की उससे छोटे-छोटे चरणों में तुलना करें: पहले समूह की घोषणाएँ, फिर उनकी IDs और उसके बाद जोड़ने वाली एक पंक्ति। अतिरिक्त सामग्री तभी वापस जोड़ें, जब बुनियादी कनेक्शन दिखाई देने लगे।

जाँचें कि आपका Obsidian संस्करण कौन-सा रेंडरर इस्तेमाल करता है

ऑनलाइन उदाहरणों से नतीजों की तुलना करने से पहले इंस्टॉल किए गए ऐप का संस्करण लिख लें। Obsidian के अपडेट दस्तावेज़ों के अनुसार ऐप और इंस्टॉलर के संस्करण Settings → General में मिलते हैं। Check for updates चुनें और अपडेट उपलब्ध हो तो Relaunch करें। इंस्टॉलर से जुड़ा कोई अलग नोटिस भी देखें। Obsidian अपडेट करें

एक महत्वपूर्ण संस्करण सीमा है: 22 अक्टूबर, 2026 के Obsidian रिलीज़ नोट्स में Desktop 1.15.0 को अर्ली ऐक्सेस रिलीज़ बताया गया है और कहा गया है कि डायग्राम Pele का इस्तेमाल करते हैं, जिसमें Mermaid 12.1.0 के सिंटैक्स की संगतता है। इन्हीं नोट्स के अनुसार, इस रिलीज़ में Obsidian अब Mermaid को शामिल नहीं करता। उन निर्देशों को संस्करण पर निर्भर मानें जिनमें यह माना गया हो कि हर Obsidian इंस्टॉलेशन में Mermaid शामिल है। Obsidian 1.15.0 Desktop (अर्ली ऐक्सेस)

इन रिलीज़ नोट्स में 1.15.0 से Show Mermaid diagrams in notes सेटिंग भी हटा दी गई है। अगर आपके इंस्टॉलेशन में यह सेटिंग या उसे सक्षम करने का प्रॉम्प्ट दिखता है, तो किसी दूसरे संस्करण के लिए बताए गए कंट्रोल को अनिश्चित समय तक खोजने के बजाय इस अंतर को दर्ज करें। Obsidian 1.15.0 Desktop (अर्ली ऐक्सेस)

समस्या का निवारण करते समय एक छोटा तुलनात्मक रिकॉर्ड रखें: ऐप का संस्करण, एडिटिंग या रीडिंग व्यू, डायग्राम का सटीक टेक्स्ट और देखा गया नतीजा। नतीजे का ठोस वर्णन करें—जैसे, “दो समूह दिखाई देते हैं, लेकिन जोड़ने वाला तीर नहीं दिखता।” सिर्फ़ यह लिखने से कि डायग्राम काम नहीं कर रहा, यह ज़्यादा उपयोगी है।

तय करें कि तीर समूहों को जोड़ना चाहिए या चीज़ों को

डायग्राम में क्या बताना है, उसके अनुसार कनेक्शन के सिरे चुनें। समूहों के बीच व्यापक संबंध के लिए कंटेनर वाला उदाहरण आज़माएँ। किसी एक चीज़ से दूसरी चीज़ तक के खास बदलाव के लिए नीचे दिया गया पूरा वैकल्पिक उदाहरण अलग से जाँचें।

```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
```

अब आख़िरी पंक्ति समूह की सीमा के पार नाम वाली चीज़ों को जोड़ती है। Mermaid के फ़्लोचार्ट दस्तावेज़ नोड, एज और सबग्राफ़ में अंतर बताते हैं; इच्छित सिरों की IDs का लगातार इस्तेमाल करें। फ़्लोचार्ट सिंटैक्स

अगर आपके इंस्टॉल किए गए रेंडरर में कंटेनर वाला उदाहरण विफल होता है, लेकिन चीज़ों वाला उदाहरण काम करता है, तो दूसरा एक व्यावहारिक विकल्प है—जब चीज़ से चीज़ का संबंध आपके इच्छित अर्थ को व्यक्त करता हो। डायग्राम में यह अंतर बनाए रखें: चीज़ों के बीच किसी खास बदलाव को इस बात का प्रमाण न दिखाएँ कि कंटेनर स्वयं जुड़े हुए हैं।

किसी भी उदाहरण को अपनाते समय एक बार में एक ही बदलाव करें। पहले दिखाई देने वाले शीर्षक बदलें, नतीजा देखें और फिर और चीज़ें जोड़ें। स्टाइलिंग और नेस्टिंग बाद के लिए रखें। इससे हर बदलाव का उद्देश्य स्पष्ट रहता है और यह पहचानना आसान होता है कि किस बदलाव के बाद समस्या शुरू हुई।

समझें कि सबग्राफ़ की दिशा क्यों बदलती है

Mermaid एक लेआउट सीमा का दस्तावेज़ देता है: जब सबग्राफ़ का कोई नोड उसके समूह के बाहर कनेक्ट होता है, तो सबग्राफ़ की अपनी दिशा नज़रअंदाज़ हो जाती है और वह पैरेंट की दिशा अपना लेता है। इसके दस्तावेज़ इसकी तुलना कंटेनर से कनेक्शन के साथ करते हैं। सबग्राफ़ की दिशा

इसलिए तीर सही हो सकता है, फिर भी उसकी व्यवस्था आपकी अपेक्षा से अलग हो सकती है। पहले उदाहरण में अंदर की कतारों और समूहों के बीच के तीर को अलग-अलग देखें। दूसरे उदाहरण में लेआउट पर राय बनाने से पहले चीज़ों के कनेक्शन के सिरों की जाँच करें। किसी भी नतीजे को समझते समय ऊपर बताया गया रेंडरर का अंतर ध्यान में रखें।

अगर आपको किसी खास चीज़ का कनेक्शन और अंदर की अलग दिशा—दोनों चाहिए, तो इन्हें स्वीकृति की अलग-अलग शर्तें मानें। Mermaid की दस्तावेज़ित सीमा का मतलब है कि स्थानीय दिशा का निर्देश जोड़ने से दोनों ज़रूरतें पूरी होने का वादा नहीं किया जा सकता। ऐसा कनेक्शन चुनें जो संबंध को सही तरह व्यक्त करे, फिर ज़रूरत पड़ने पर व्यवस्था को सरल बनाएँ।

एक उपयोगी विकल्प है कि पूरी डायग्राम में एक ही दिशा रखें और उसे इतना छोटा करें कि जुड़ी हुई चीज़ों को आसानी से समझा जा सके। अगर समूह-स्तर का अर्थ पर्याप्त है, तो पहले उदाहरण पर लौटें। ये इस बारे में संपादकीय चुनाव हैं कि डायग्राम क्या बताएगा; सटीक स्थानों या तीरों के रास्ते की गारंटी नहीं।

डायग्राम दोबारा बनाने से पहले समस्या को अलग करें

आगे क्या आज़माना है, यह तय करने के लिए इस जाँच क्रम का उपयोग करें। यह दस्तावेज़ित सिंटैक्स और रेंडरर की सीमाओं पर आधारित निर्णय सहायता है, पुष्ट खराबियों की सूची नहीं।

देखा गया नतीजा अगली जाँच क्या दर्ज करें
नोट में डायग्राम का टेक्स्ट जस का तस दिखाई देता है शुरुआती और आख़िरी कोड फ़ेंस जाँचें, फिर Reading view पर जाएँ क्या ब्लॉक रेंडर होता है
न्यूनतम उदाहरण में त्रुटि आती है पेस्ट किए गए ब्लॉक के हर अक्षर की उदाहरण से तुलना करें त्रुटि का पूरा टेक्स्ट
समूह रेंडर होते हैं, लेकिन उनका कनेक्शन नहीं दिखता चीज़ों को जोड़ने वाले पूरे वैकल्पिक उदाहरण को अलग से आज़माएँ कौन-सा सिरा प्रकार काम करता है
तीर दिखाई देता है, लेकिन अंदर की दिशा बदल जाती है बाहरी नोड के कारण दिशा बदलने की दस्तावेज़ित सीमा देखें क्या कनेक्शन या व्यवस्था अब भी समस्या है
ज़्यादा सामग्री लौटाने तक उदाहरण काम करता है सबसे नया जोड़ा हुआ हिस्सा हटाएँ और उसी बदलाव को दोहराएँ वह सबसे छोटा जोड़ जिसके बाद समस्या आई
वही टेक्स्ट दूसरी जगह अलग व्यवहार करता है ऐप के संस्करणों, रेंडरर और व्यू मोड की तुलना करें सटीक परिवेश और नतीजे

सिंटैक्स की स्वतंत्र तुलना के लिए Obsidian के दस्तावेज़ Mermaid के Live Editor का सुझाव देते हैं। आसपास के Markdown फ़ेंस हटाकर वहाँ सिर्फ़ डायग्राम का टेक्स्ट पेस्ट करें। ब्राउज़र में सफल रेंडरिंग तुलना के लिए उपयोगी सबूत है, लेकिन इससे यह साबित नहीं होता कि आपके Obsidian संस्करण में भी व्यवहार बिल्कुल वैसा ही होगा। उन्नत फ़ॉर्मैटिंग सिंटैक्स

अगर Obsidian में नतीजा अब भी अलग है, तो डेस्कटॉप सैंडबॉक्स वॉल्ट में न्यूनतम जाँच दोहराएँ। Obsidian की आधिकारिक समस्या-निवारण गाइड सामान्य वॉल्ट सेटअप के बाहर किसी समस्या को दोहराने की डेस्कटॉप जाँच के रूप में Open Help > Sandbox Vault बताती है। आगे की जाँच से पहले वह कम्युनिटी थीम और प्लगइन अपडेट करने और ऐप रीस्टार्ट करने का भी सुझाव देती है। Bug reports श्रेणी के बारे में

अगर सैंडबॉक्स में काम करता है, तो मूल वॉल्ट के अंतरों की एक-एक करके जाँच करें। अगर वहाँ भी विफल होता है, तो न्यूनतम उदाहरण, ऐप और इंस्टॉलर के संस्करण, व्यू मोड और देखे गए सटीक नतीजे अपने पास रखें। रिपोर्ट करने से पहले, Obsidian की रिपोर्टिंग गाइड के अनुसार फ़ोरम में पहले से मौजूद मिलती-जुलती रिपोर्ट खोजें। Bug reports श्रेणी के बारे में

अंत में ऐसा सबसे छोटा डायग्राम रखें जो ज़रूरी संबंध को स्पष्ट करे। जब समूह ही कनेक्शन के इच्छित सिरे हों, तो कंटेनर कनेक्शन रखें; जब बदलाव खास चीज़ों के बीच हो, तो चीज़ों का कनेक्शन रखें। आपके इंस्टॉल किए गए Obsidian संस्करण में यह विकल्प ठीक से रेंडर हो जाए, तो अतिरिक्त जानकारी धीरे-धीरे जोड़ें और जब तक डायग्राम पढ़ने योग्य रहे, वहीं रुकें।

स्रोत