Lo que se conserva
Para convertir una exportación de Confluence a Markdown se lee cada archivo .html del .zip que genera la exportación HTML de un espacio. Por defecto, el espacio se convierte en una carpeta de páginas: un documento Markdown por página, una subcarpeta por sección y, dentro de ella, la página de la propia sección en primer lugar. La opción Un solo documento reúne en cambio todas las páginas en un único archivo.
| En la exportación | En el Markdown |
|---|---|
El título, escrito Espacio : Página |
# Página, sin el nombre del espacio |
| La ruta de navegación | La carpeta en la que queda la página |
| Encabezados, listas, negrita, cursiva | Lo mismo, en Markdown |
| Una tabla | Una tabla Markdown, con la primera fila como encabezado |
| La macro de tabla de contenidos, un enlace a un encabezado | Un enlace al slug del encabezado, al estilo de GitHub |
| Un enlace a otra página | Un enlace a esa página, en una carpeta de páginas |
Una imagen en attachments/ |
Incrustada en la página; las más pesadas, reducidas antes a 1.600 píxeles como máximo por el lado largo |
| Un enlace a una dirección web | Se mantiene como enlace |
Lo que se pierde
- Las macros como macros. Ninguna tiene una regla propia: cada una llega como el HTML que la exportación generó a partir de ella, de modo que un panel de información queda en sus párrafos, sin el panel.
- Las celdas combinadas. El texto va a la primera celda que cubría y, debajo de una celda combinada hacia abajo, la fila se desplaza a la izquierda. Una celda con varios párrafos o una lista se aplana en una sola línea.
- Los adjuntos que no son imágenes. Un PDF no se incluye, así que en una carpeta de páginas su enlace queda en su nombre, igual que los enlaces a pantallas propias de Confluence.
- Las imágenes que superan el margen. En una carpeta de páginas, cada página puede llevar casi 4 MB de imágenes, ninguna de más de 1 MB una vez codificada; la que ya no cabe queda como su texto alternativo o su nombre de archivo en cursiva. Un solo documento comparte 2 MB, y una imagen que no cabe conserva su ruta
attachments/.
Un ejemplo
Una exportación de espacio en la que la página «Deploy checklist», dentro de «Runbooks», contiene una macro de tabla de contenidos, un encabezado, una tabla, un enlace a la página «Rollback», un runbook.pdf enlazado y una captura de pantalla. Como carpeta de páginas, descargada en .zip, se convierte en Engineering/Runbooks/Deploy checklist.md (datos de la imagen abreviados, sin el marco de la página):
# Deploy checklist
- [Before you deploy](#before-you-deploy)
## Before you deploy
| Step | Owner |
| --- | --- |
| Tag the release | Ops |
| Announce the freeze | Release lead |
If it fails, follow [Rollback](Rollback.md). The full runbook is runbook.pdf.
La entrada de la tabla de contenidos apuntaba al identificador propio de Confluence, Deploychecklist-Beforeyoudeploy, y ahora salta al encabezado por su slug. Como un solo documento, la página sería una sección bajo una lista # Contents con los títulos de las páginas.
Límites
El .zip puede pesar hasta 250 MB; solo se descomprimen las páginas y las imágenes, y se rechaza un .zip sin archivos .html. La conversión se hace en su navegador: sin iniciar sesión no se sube nada, y con la sesión iniciada nada llega a su cuenta hasta que guarde. Una página guardada puede pesar hasta 4 MB.
Las páginas se ordenan por nombre de archivo, con index.html primero, y no según el árbol de páginas de Confluence. Nada aísla el contenido principal: salvo la ruta de navegación, el marco de la página llega como texto, por ejemplo un encabezado que repite el nombre del espacio, una línea de autor o una línea «Document generated by Confluence». Conviene revisar los bloques de código: un bloque de código delimitado solo aparece donde el HTML tiene <code> dentro de <pre>, y un <pre> solo llega como líneas sueltas. Las marcas de verificación se leen únicamente de casillas HTML, sin regla para las listas de tareas de Confluence.
Hay más sobre las macros en convertir una página de Confluence a Markdown y sobre el .zip en cómo abrir un .zip de exportación.
Preguntas
¿Es una aplicación o un plugin de Confluence?
No. No se instala nada en Confluence y nada se conecta a él: se exporta el espacio en HTML y se suelta el .zip aquí. Las opciones gratuitas comparadas repasa también las aplicaciones del Marketplace.
¿Funciona con exportaciones de Confluence Cloud y de Data Center?
Ninguna de las dos tiene un tratamiento aparte: el conversor lee lo mismo de cualquier exportación HTML, es decir, el <title> de cada página, su ruta de navegación, los identificadores de sus encabezados y su nombre de archivo. En cualquier caso, esta página admite el .zip de la exportación HTML y ningún otro archivo.
¿Se puede convertir una sola página de Confluence a Markdown?
Sí, siempre que llegue en HTML dentro de un .zip. Se lee cada archivo .html del .zip, así que una página se convierte igual que seiscientas.
¿Se puede obtener HTML en lugar de Markdown?
Elija Un solo documento: el menú de descarga del resultado ofrece HTML, Word y texto sin formato junto al Markdown. Una carpeta de páginas se descarga solo en Markdown.
¿Siguen funcionando los enlaces entre páginas?
En una carpeta de páginas, sí: cada uno apunta al documento guardado en su cuenta o al archivo de la página enlazada dentro del .zip descargado. En un solo documento conservan los nombres de archivo de la exportación, que fuera de ella no llevan a ninguna parte.