[Marklas] Conversor bidirecional entre Markdown <-> Atlassian Document Format (ADF)

Confluence e Jira armazenam documentos em uma estrutura JSON chamada ADF (Atlassian Document Format). Ao ler e escrever páginas via API, é preciso lidar diretamente com esse formato, mas recursos exclusivos do ADF, como painéis, menções e texto colorido, se perdem ao converter para Markdown.

O Marklas resolve esse problema preservando recursos exclusivos do ADF como anotações em comentários HTML.

<!-- adf:panel {"panelType": "warning"} -->  
Esta API será removida na v2.  
<!-- /adf:panel -->  

As anotações não são renderizadas no GitHub nem em editores, então não afetam a legibilidade, e, ao fazer o parse novamente, a estrutura ADF original é restaurada exatamente como era.

ADF → Markdown (com anotações) → ADF       ✅ perda mínima  
Markdown comum → ADF                       ✅ funciona  

from marklas import to_adf, to_md  
  
md = to_md(confluence_adf)       # Converter para Markdown e editar  
adf = to_adf(md)                 # Restaurar para ADF novamente  

Depois de usar bibliotecas comerciais de conversão já existentes e sentir incômodo com elas, resolvi criar a minha própria.

Python 3.13+, com apenas uma dependência externa: mistune.