Ao importar páginas do Confluence para o Notion, alguns conteúdos aparecem como blocos vazios ou texto de erro bruto, em vez das informações formatadas que você espera. Esse problema ocorre porque o Notion não consegue processar blocos de macro do Confluence — elementos de conteúdo automatizados, como issues do Jira, gráficos ou tabelas dinâmicas que o Confluence renderiza no servidor. Este artigo explica por que os blocos de macro quebram durante a importação e fornece etapas específicas para identificar, substituir e transferir manualmente esse conteúdo, para que seu espaço de trabalho no Notion fique completo.
Principais conclusões: Corrigindo erros de importação de blocos de macro do Confluence
- Confluence > Exportar > HTML ou XML: Use a exportação HTML para preservar mais conteúdo de macro do que a importação direta padrão do Confluence para o Notion.
- Identificação manual de macros: Revise a página importada em busca de caixas cinzas com o rótulo “Tipo de bloco não suportado” — elas marcam onde as macros falharam.
- Ferramenta de terceiros (ex.: Relational.io): Converte macros do Confluence em blocos compatíveis com o Notion, economizando horas de redigitação manual.
Por que os blocos de macro do Confluence falham durante a importação para o Notion
As macros do Confluence são componentes renderizados no servidor que geram conteúdo dinâmico — listas de issues do Jira, gráficos de status, tabelas de decisão e cartões de perfil de usuário. Quando o Notion importa uma página do Confluence, ele recebe a marcação bruta ou um instantâneo HTML da página. O Notion não possui um renderizador interno para a sintaxe de macro do Confluence, portanto, não consegue interpretar as instruções da macro.
O processo de importação geralmente resulta em um dos três resultados para o conteúdo de macro:
- O bloco de macro aparece como uma mensagem de erro em texto simples (ex.: “[Macro não suportada: jira-issues]”)
- O bloco mostra uma área cinza vazia com o rótulo “Tipo de bloco não suportado”
- O conteúdo da macro é descartado silenciosamente, deixando uma lacuna na estrutura da página
Esse comportamento não é um bug — é uma limitação de design. Confluence e Notion usam arquiteturas de conteúdo diferentes. O Confluence depende de um sistema de macros baseado em plugins, enquanto o Notion usa um editor baseado em blocos com um conjunto fixo de tipos de bloco nativos. Nenhuma ferramenta de importação direta consegue traduzir todas as macros porque as duas plataformas não compartilham um modelo de conteúdo comum para elementos dinâmicos.
Tipos de macro que comumente quebram
As seguintes macros do Confluence quase sempre falham durante a importação:
- Macro de Issue/Filtro do Jira: Exibe uma lista ao vivo de issues do Jira com base em uma consulta JQL
- Macro de Gráfico: Renderiza gráficos de pizza, barras ou linhas a partir de dados de tabela
- Macro de Status: Mostra um rótulo de status colorido (ex.: “Em andamento”, “Concluído”)
- Macro de Perfil: Exibe um avatar de usuário e detalhes do diretório de usuários do Confluence
- Macro de Sumário: Gera um sumário dinâmico a partir dos cabeçalhos da página
- Macro Incluir Página: Incorpora conteúdo de outra página do Confluence
- Macro Office Excel/Word: Incorpora uma visualização de um documento do Office armazenado no Confluence
Etapas para identificar e substituir conteúdo de macro quebrado
Siga este processo para localizar cada bloco de macro com falha em sua página importada do Notion e substituí-lo por conteúdo equivalente do Notion.
- Abra a página importada no Notion
Navegue até a página criada a partir da importação do Confluence. Percorra toda a página. Procure por caixas cinzas com o texto “Tipo de bloco não suportado” ou texto de erro bruto como “[Macro não suportada: …]”. - Faça uma lista de cada macro com falha
Para cada bloco não suportado, anote o nome da macro mostrado no texto de erro. Por exemplo, se você vir “[Macro não suportada: jira-issues]”, anote “jira-issues”. Esta lista informa qual conteúdo está faltando. - Abra a página original do Confluence em um navegador
Volte para a instância do Confluence onde a página se originou. Abra a mesma página e localize cada macro que você identificou. Copie a saída renderizada — o texto, números ou links que a macro gerou. - Substitua o bloco quebrado por um equivalente do Notion
No Notion, exclua o bloco não suportado. Insira o tipo de bloco apropriado do Notion em seu lugar. Para uma lista de issues do Jira, use um banco de dados do Notion com integração Jira. Para um gráfico, crie uma tabela no Notion e use uma ferramenta de incorporação de gráficos como Whimsical ou bloco Mermaid. Para um sumário, use o bloco Sumário nativo do Notion. - Use a exportação HTML do Confluence para conteúdo mais rico
Em vez de usar a importação direta do Confluence para o Notion, exporte o espaço do Confluence como HTML. No Confluence, vá em Configurações do Espaço > Ferramentas de Conteúdo > Exportar > Exportar como HTML. Baixe o arquivo ZIP. Depois, no Notion, use Importar > HTML para carregar os arquivos exportados. A exportação HTML preserva mais conteúdo de macro como texto estático e imagens. - Use uma ferramenta de migração de terceiros para macros em massa
Se você tem dezenas de macros em várias páginas, a substituição manual é muito lenta. Ferramentas como Relational.io ou CloudFuze podem converter macros do Confluence em blocos compatíveis com o Notion. Essas ferramentas analisam as definições das macros e criam blocos nativos do Notion — por exemplo, transformando uma macro de issue do Jira em uma visualização de banco de dados do Notion vinculada.
Se o Notion ainda tiver problemas após a correção principal
A página importada contém conteúdo duplicado
Às vezes, a importação cria duas cópias do mesmo conteúdo de macro — uma como bloco não suportado e outra como texto estático. Exclua o bloco não suportado e mantenha a versão de texto estático. Para evitar duplicatas, use a exportação XML do Confluence em vez da exportação HTML. A exportação XML produz um único arquivo estruturado que o Notion processa de forma mais limpa.
A macro de issue do Jira mostra apenas um erro
A macro de issue do Jira não pode ser importada porque depende de uma conexão ativa com o Jira. No Notion, crie um novo banco de dados e use a integração Jira (Configurações e Membros > Conexões > Jira) para puxar as issues diretamente. Isso fornece uma visualização ao vivo e atualizada, em vez de um instantâneo estático.
A macro Incluir Página resulta em uma área em branco
A macro Incluir Página incorpora conteúdo de outra página do Confluence. O Notion não consegue resolver essa referência. Abra manualmente a página incluída no Confluence, copie seu conteúdo e cole-o na página do Notion no mesmo local. Se a página incluída mudar com frequência, considere vincular à página do Confluence como um marcador em vez de incorporar o conteúdo.
A macro de Sumário não aparece
O Notion tem seu próprio bloco de Sumário. Digite /sumário em uma nova linha e pressione Enter. O bloco gera automaticamente uma lista de cabeçalhos da página atual. Isso funciona melhor do que a versão do Confluence porque é atualizado em tempo real conforme você edita os cabeçalhos.
Métodos de importação de macro do Confluence comparados
| Item | Importação Direta Confluence-para-Notion | Exportação HTML e Depois Importação | Ferramenta de Terceiros (ex.: Relational.io) |
|---|---|---|---|
| Suporte a macros | Nenhum — todas as macros se tornam blocos não suportados | Parcial — algumas macros são renderizadas como texto estático ou imagens | Alto — converte macros em blocos nativos do Notion |
| Esforço para importação pequena (menos de 10 páginas) | Baixo — a importação é executada automaticamente | Médio — requer exportação e limpeza manual | Alto — ferramenta paga com tempo de configuração |
| Esforço para importação grande (mais de 100 páginas) | Importação baixa, mas limpeza alta | Exportação média, limpeza alta | Baixo — conversão em massa com trabalho manual mínimo |
| Custo | Gratuito | Gratuito | Assinatura ou taxa por migração |
Após a importação, você agora pode identificar cada macro do Confluence que falhou ao renderizar e substituí-la por um bloco nativo do Notion. Para uma única página, use o método de substituição manual com a página original do Confluence aberta. Para uma migração completa do espaço de trabalho, invista em uma ferramenta de terceiros que converta macros automaticamente. Como dica avançada, antes de importar, execute um relatório de inventário de macros do Confluence (disponível em Administração do Confluence > Ferramentas de Conteúdo > Uso de Macros) para saber exatamente quais macros existem em seu espaço — isso permite planejar substituições antes de iniciar a importação.