Saindo do Mermaid for Confluence, Swagger UI for Confluence ou PowerPlantUML
Estes três apps do Confluence Cloud ainda rodam no Atlassian Connect e não recebem atualização desde que a Atlassian congelou as atualizações do Connect. A Atlassian encerra o suporte ao Connect em 31 de janeiro de 2027. O Specdock é criado no Forge e cobre os três: diagramas Mermaid, documentação Swagger/OpenAPI e diagramas PlantUML, em qualquer página.
Quais apps são afetados
| App | Instalações | Última atualização | Substituir por |
|---|---|---|---|
| Mermaid for Confluence (Tech Labs) | cerca de 800 | dezembro de 2024 | a macro de diagramas Mermaid do Specdock |
| Swagger UI for Confluence (Tech Labs) | cerca de 650 | abril de 2025 | a macro OpenAPI / Swagger do Specdock |
| PowerPlantUML | cerca de 430 | maio de 2022 | a macro de diagramas PlantUML do Specdock |
Fonte: Atlassian Marketplace, consultado em 14 de novembro de 2026.
Como migrar, em quatro passos
- Um administrador do Confluence instala o Specdock pelo Atlassian Marketplace (grátis até 10 usuários).
- Abra Configurações → Configurações do Specdock e execute o scanner de migração em um espaço. Ele lista cada página que ainda usa uma macro antiga de Swagger/OpenAPI, Mermaid ou PlantUML, com o texto da especificação ou do diagrama.
- Em cada página, digite / e adicione a macro de diagrama Mermaid, diagrama PlantUML ou documentação OpenAPI / Swagger do Specdock, e cole o texto (ou aponte para o mesmo anexo, arquivo Git ou URL).
- Confira a página, remova a macro antiga e publique. Quando não restarem páginas, desinstale o app antigo.
O que você ganha no Forge
- Roda na Atlassian: nenhum servidor externo guarda suas páginas.
- Especificações de anexos, GitHub, GitLab ou Bitbucket Cloud (inclusive repositórios privados), para a documentação não ficar desatualizada.
- OpenAPI 3.x, Swagger 2.0 e AsyncAPI, além de um relatório de mudanças incompatíveis entre duas versões.
Perguntas
Minhas páginas de Mermaid, Swagger ou PlantUML vão quebrar em 31 de janeiro de 2027?
A Atlassian encerra o suporte a apps Connect em 31 de janeiro de 2027. Apps que continuarem no Connect depois dessa data deixam de ter suporte e podem parar de funcionar. Se o seu app não migrou para o Forge, planeje substituir as macros antes.
Como encontro as páginas que usam o app antigo?
Instale o Specdock, abra Configurações → Configurações do Specdock e execute o scanner de migração em um espaço. Ele lista as páginas que ainda usam uma macro antiga de Swagger/OpenAPI, Mermaid ou PlantUML, com o texto da especificação ou do diagrama de cada uma.
Preciso reescrever meus diagramas?
Não. O texto de Mermaid e PlantUML funciona como está: copie o texto exibido pelo scanner para a macro de Mermaid ou PlantUML do Specdock. Para Swagger/OpenAPI, aponte a macro para o mesmo anexo, arquivo Git ou URL.
Meu app antigo ainda está no Connect?
Confira na consulta gratuita do nosso guia sobre o fim do Connect. Ela lê a versão mais recente do app no Atlassian Marketplace e diz se ele está no Forge, migrando ou em risco.
Quanto custa o Specdock?
Grátis até 10 usuários. Acima disso, a cobrança é por usuário por mês, pela Atlassian.
Não sabe quais dos seus apps estão no Connect? Use a consulta gratuita do guia sobre o fim do Connect. Mais sobre o Specdock: documentação.