[Marklas] Markdown <-> Atlassian Document Format(ADF) द्विदिश कन्वर्टर

Confluence और Jira दस्तावेज़ों को ADF(Atlassian Document Format) नामक JSON संरचना में संग्रहीत करते हैं। API से पेज पढ़ते और लिखते समय इस फ़ॉर्मैट को सीधे संभालना पड़ता है, लेकिन panel, mention, color text जैसी ADF-विशिष्ट सुविधाएँ Markdown में कन्वर्ट करने पर खो जाती हैं।

Marklas इस समस्या को ADF-विशिष्ट सुविधाओं को HTML comment annotation के रूप में संरक्षित करके हल करता है.

<!-- adf:panel {"panelType": "warning"} -->  
यह API v2 में हटाई जाने वाली है।  
<!-- /adf:panel -->  

Annotations GitHub या editor में render नहीं होते, इसलिए readability पर असर नहीं पड़ता, और दोबारा parse करने पर मूल ADF संरचना ज्यों की त्यों बहाल हो जाती है।

ADF → Markdown(annotations सहित) → ADF       ✅ न्यूनतम loss  
सामान्य Markdown → ADF                        ✅ काम करता है  

from marklas import to_adf, to_md  
  
md = to_md(confluence_adf)       # Markdown में कन्वर्ट करके संपादित करें  
adf = to_adf(md)                 # फिर से ADF में बहाल करें  

मौजूदा commercial conversion library का उपयोग करते समय असुविधा महसूस हुई, इसलिए इसे सीधे खुद बनाया गया।

Python 3.13+, external dependency केवल mistune है.