[Marklas] Markdown <-> Atlassian Document Format(ADF) çift yönlü dönüştürücü

Confluence ve Jira, belgeleri ADF (Atlassian Document Format) adlı JSON yapısında saklar. API ile sayfaları okuyup yazarken bu formatı doğrudan ele almak gerekir; ancak panel, mention ve renkli metin gibi ADF’ye özgü özellikler Markdown’a dönüştürüldüğünde kaybolur.

Marklas, ADF’ye özgü özellikleri HTML yorum anotasyonlarıyla koruyarak bu sorunu çözüyor.

<!-- adf:panel {"panelType": "warning"} -->  
Bu API, v2 sürümünde kaldırılacak.  
<!-- /adf:panel -->  

Anotasyonlar GitHub’da veya editörde render edilmediği için okunabilirliği etkilemez; yeniden parse edildiğinde ise özgün ADF yapısı aynen geri yüklenir.

ADF → Markdown (anotasyonlarla birlikte) → ADF       ✅ minimum veri kaybı  
Normal Markdown → ADF                                ✅ çalışır  

from marklas import to_adf, to_md  
  
md = to_md(confluence_adf)       # Markdown'a dönüştürüp düzenle  
adf = to_adf(md)                 # yeniden ADF olarak geri yükle  

Mevcut ticari dönüştürme kütüphanelerini kullanırken yaşadığım rahatsızlık nedeniyle bunu kendim yaptım.

Python 3.13+, tek dış bağımlılık mistune.