[Marklas] Convertidor bidireccional de Markdown <-> Atlassian Document Format (ADF)

Confluence y Jira guardan los documentos en una estructura JSON llamada ADF (Atlassian Document Format). Al leer y escribir páginas mediante la API, hay que manejar este formato directamente, pero las funciones exclusivas de ADF como paneles, menciones y texto con color se pierden al convertirlas a Markdown.

Marklas resuelve este problema preservando las funciones exclusivas de ADF como anotaciones en comentarios HTML.

<!-- adf:panel {"panelType": "warning"} -->  
Esta API será eliminada en la v2.  
<!-- /adf:panel -->  

Como las anotaciones no se renderizan en GitHub ni en los editores, no afectan la legibilidad, y al volver a parsearlas se restaura intacta la estructura ADF original.

ADF → Markdown (con anotaciones) → ADF       ✅ pérdida mínima  
Markdown normal → ADF                        ✅ funciona  

from marklas import to_adf, to_md  
  
md = to_md(confluence_adf)       # Convertir a Markdown para editar  
adf = to_adf(md)                 # Restaurar nuevamente a ADF  

Lo creé yo mismo después de sentir incomodidad al usar bibliotecas comerciales de conversión existentes.

Python 3.13+, la única dependencia externa es mistune.