Dejar Mermaid for Confluence, Swagger UI for Confluence o PowerPlantUML
Estas tres apps de Confluence Cloud siguen en Atlassian Connect y no se han actualizado desde que Atlassian congeló las actualizaciones de Connect. Atlassian termina el soporte de Connect el 31 de enero de 2027. Specdock está creado sobre Forge y cubre las tres: diagramas Mermaid, documentación Swagger/OpenAPI y diagramas PlantUML, en cualquier página.
Qué apps están afectadas
| App | Instalaciones | Última actualización | Sustituir por |
|---|---|---|---|
| Mermaid for Confluence (Tech Labs) | unas 800 | diciembre de 2024 | la macro de diagramas Mermaid de Specdock |
| Swagger UI for Confluence (Tech Labs) | unas 650 | abril de 2025 | la macro OpenAPI / Swagger de Specdock |
| PowerPlantUML | unas 430 | mayo de 2022 | la macro de diagramas PlantUML de Specdock |
Fuente: Atlassian Marketplace, consultado el 14 de noviembre de 2026.
Cómo cambiar, en cuatro pasos
- Un administrador de Confluence instala Specdock desde Atlassian Marketplace (gratis hasta 10 usuarios).
- Abre Configuración → Configuración de Specdock y ejecuta el escáner de migración en un espacio. Lista cada página que aún usa una macro antigua de Swagger/OpenAPI, Mermaid o PlantUML, con su texto de especificación o diagrama.
- En cada página, escribe / y añade la macro de diagrama Mermaid, diagrama PlantUML o documentación OpenAPI / Swagger de Specdock, y pega el texto (o apúntala al mismo adjunto, archivo de Git o URL).
- Revisa la página, quita la macro antigua y publica. Cuando no queden páginas, desinstala la app antigua.
Qué obtienes con Forge
- Se ejecuta en Atlassian: ningún servidor externo guarda tus páginas.
- Especificaciones desde adjuntos, GitHub, GitLab o Bitbucket Cloud (también repositorios privados), para que la documentación no quede obsoleta.
- OpenAPI 3.x, Swagger 2.0 y AsyncAPI, además de un informe de cambios incompatibles entre dos versiones.
Preguntas
¿Se romperán mis páginas de Mermaid, Swagger o PlantUML el 31 de enero de 2027?
Atlassian termina el soporte de las apps Connect el 31 de enero de 2027. Las apps que sigan en Connect después de esa fecha no tendrán soporte y pueden dejar de funcionar. Si tu app no ha pasado a Forge, planifica sustituir sus macros antes.
¿Cómo encuentro las páginas que usan la app antigua?
Instala Specdock, abre Configuración → Configuración de Specdock y ejecuta el escáner de migración en un espacio. Lista las páginas que aún usan una macro antigua de Swagger/OpenAPI, Mermaid o PlantUML, con el texto de especificación o diagrama de cada una.
¿Tengo que reescribir mis diagramas?
No. El texto de Mermaid y PlantUML funciona tal cual: copia el texto que muestra el escáner en la macro de Mermaid o PlantUML de Specdock. Para Swagger/OpenAPI, apunta la macro al mismo adjunto, archivo de Git o URL.
¿Mi app antigua sigue en Connect?
Compruébalo con la consulta gratuita de nuestra guía sobre el fin de Connect. Lee la última versión de la app en Atlassian Marketplace e indica si está en Forge, migrando o en riesgo.
¿Cuánto cuesta Specdock?
Gratis hasta 10 usuarios. Por encima, se factura por usuario y mes a través de Atlassian.
¿No sabes cuáles de tus apps están en Connect? Usa la consulta gratuita de la guía sobre el fin de Connect. Más sobre Specdock: documentación.