[Marklas] Konverter dua arah Markdown <-> Atlassian Document Format (ADF)

Confluence dan Jira menyimpan dokumen dalam struktur JSON bernama ADF (Atlassian Document Format). Saat membaca dan menulis halaman lewat API, format ini harus ditangani secara langsung, tetapi fitur khusus ADF seperti panel, mention, dan teks berwarna akan hilang jika dikonversi ke Markdown.

Marklas menyelesaikan masalah ini dengan mempertahankan fitur khusus ADF sebagai anotasi komentar HTML.

<!-- adf:panel {"panelType": "warning"} -->  
API ini dijadwalkan akan dihapus pada v2.  
<!-- /adf:panel -->  

Anotasi ini tidak dirender di GitHub atau editor sehingga tidak memengaruhi keterbacaan, dan saat diparse kembali, struktur ADF asli dapat dipulihkan apa adanya.

ADF → Markdown (dengan anotasi) → ADF       ✅ Kehilangan minimal  
Markdown biasa → ADF                        ✅ Berfungsi  

from marklas import to_adf, to_md  
  
md = to_md(confluence_adf)       # Konversi ke Markdown untuk diedit  
adf = to_adf(md)                 # Pulihkan kembali ke ADF  

Saya membuatnya sendiri setelah merasa kurang nyaman saat menggunakan library konversi komersial yang sudah ada.

Python 3.13+, dependensi eksternal hanya mistune.