Con esta herramienta puedes convertir Markdown a Confluence: genera wiki markup para el diálogo «Insertar marcado» o formato de almacenamiento (XHTML) para la API REST. Pega el texto o abre un archivo .md y copia el resultado.
Última actualización:
Cómo funciona
Pega tu Markdown
Pega un README o un runbook, abre un archivo .md, usa Abrir desde URL o Cargar ejemplo.
Elige el destino
En Formato de salida, elige Wiki markup para el editor o Formato de almacenamiento (XHTML) para la API; ajusta Alertas y notas.
Copia en Confluence
En el editor, haz clic en + → Marcado → Confluence wiki y pega. Para la API, envía el XML como cuerpo de la página.
Funciones
Dos formatos de salida
Wiki markup (h2., {code}, ||tablas||) o formato de almacenamiento con elementos ac:structured-macro para código, paneles info y listas de tareas.
Las notas se convierten en macros
Las alertas de GitHub como > [!NOTE] o > [!WARNING] pasan a ser macros {info}, {tip}, {note} y {warning}, no simples citas.
Código con lenguaje y título
Los bloques de código delimitados conservan el lenguaje (con el nombre que Confluence resalta) y el title="…" de la línea de apertura.
Advertencias claras
Lo que Confluence no puede representar, como notas al pie o la alineación de tablas en wiki markup, se lista bajo el resultado.
Límites y privacidad
Archivos de hasta 10 MB. Las entradas de más de 256 KB se convierten en un Web Worker, así que la página sigue respondiendo. No se sube nada: la conversión se hace en tu navegador y Abrir desde URL descarga el archivo directamente desde la dirección que escribas. Más información en la página de privacidad.
Qué cambia al pasar a Confluence
En wiki markup, un salto de línea simple dentro de un párrafo es un salto forzado, por eso las líneas con ajuste suave se unen con espacios. Las listas no pueden contener bloques de código ni un segundo párrafo: esos bloques se colocan justo después del elemento y se muestra una advertencia. Las notas al pie pasan a números en superíndice con las notas al final, porque Confluence no tiene macro para ellas.
Las imágenes conservan su URL; los adjuntos tienes que subirlos a la página por separado. Las fórmulas se mantienen como TeX monoespaciado, salvo que tu sitio tenga instalada una app de LaTeX.
Preguntas frecuentes
¿Cómo pego Markdown en Confluence?
Conviértelo aquí y, en el editor de Confluence, elige Insertar → Marcado, selecciona Confluence wiki, pega el texto y presiona Insertar.
¿Confluence Cloud admite Markdown?
El editor de Cloud interpreta algo de Markdown al escribir, pero al pegar un documento se pierden tablas, lenguajes de código y paneles. Con «Insertar marcado» se conservan.
¿Qué es el formato de almacenamiento de Confluence?
Es el formato basado en XHTML en el que Confluence guarda las páginas. Úsalo con la API REST o con herramientas que publican páginas desde Git.
¿Se convierten las listas de tareas?
Sí. En formato de almacenamiento se vuelven tareas reales de Confluence; el wiki markup no tiene sintaxis de tareas, así que quedan como caracteres ☐ y ☑.
¿Puedo agregar una tabla de contenidos?
Sí. Activa Tabla de contenidos y se inserta la macro {toc} al principio de la página.
¿Se sube mi documento a algún servidor?
No. La conversión de Markdown a Confluence se hace por completo en tu navegador.