Migração do Notion para o Obsidian: Checklist de Importação via API vs HTML

A maneira mais segura de migrar do Notion para o Obsidian depende do conteúdo do seu espaço de trabalho. Use a importação oficial via API do Notion quando bancos de dados e fórmulas forem essenciais. Use a importação de arquivos HTML do Notion quando desejar um processo offline, sem necessidade de token, e puder recriar as visualizações de banco de dados por conta própria.

Não trate a migração como um simples exercício de cópia de arquivos. Primeiro, decida quais fluxos de trabalho precisam sobreviver: notas vinculadas, registros de projetos, planejamento diário, tarefas recorrentes, reuniões ou visualizações de banco de dados. Em seguida, importe para um vault de teste, verifique os fluxos importantes e mantenha o Notion disponível até que o novo vault passe no checklist ao final deste guia.

Decisão rápida: Importação via API ou HTML?

Sua situação	Escolha	O que preserva	Principal desvantagem
Bancos de dados, propriedades e fórmulas são centrais	Notion (API)	Páginas, entradas de bancos de dados, propriedades e fórmulas convertidas para Markdown e Bases	Exige um token de integração do Notion, acesso às páginas e conexão com a internet
Você prefere um processo sem tokens ou offline	Notion (.zip)	Páginas, anexos, hierarquia e links a partir de uma exportação HTML	As visualizações e estruturas de banco de dados não são transferidas como Bases ativas
Você precisa apenas de um pequeno conjunto de notas	Importação via API com acesso limitado a essas páginas, ou exportação HTML no nível da página	As notas selecionadas e seus anexos disponíveis	Links para conteúdos fora do escopo selecionado precisam de revisão
Você precisa de colaboração e permissões em tempo real	Mantenha esse fluxo no Notion ou combine o Obsidian com uma ferramenta de equipe	O contexto de conhecimento ainda pode ser movido para o Obsidian	O Obsidian não é um substituto direto para espaços de trabalho compartilhados no Notion

Esta tabela reflete a documentação atual do Obsidian Importer. O importador via API é descrito como recente; portanto, revise suas limitações antes de uma grande migração. Em particular, apenas a visualização principal de cada banco de dados é importada, fontes de dados vinculadas não são importadas e algumas funções do Notion não são convertidas.

Antes de migrar

Crie um inventário rápido. Marque cada item como preservar obrigatoriamente, recriar ou descartar.

• Notas e páginas aninhadas que você ainda usa.
• Links internos, backlinks e anexos importantes.
• Bancos de dados, propriedades, relações, rollups, fórmulas e visualizações.
• Notas diárias, tarefas recorrentes, status de projetos e acompanhamento de reuniões.
• Páginas compartilhadas, comentários, permissões, automações e integrações.
• O caminho de backup e sincronização para o novo vault local.

Use o inventário para escolher o caminho de importação. Um espaço de trabalho grande e repleto de bancos de dados exige um plano diferente de uma pasta de notas de reunião. Se desejar uma comparação mais ampla antes da mudança, leia Obsidian vs Notion para produtividade.

Crie um ambiente de teste seguro

1. Mantenha o espaço de trabalho original do Notion intacto.
2. Crie um novo vault de teste vazio no Obsidian.
3. Exporte ou importe primeiro uma amostra representativa: uma página comum, uma página aninhada, uma página vinculada, um anexo e um banco de dados.
4. Registre o que chegou corretamente e o que precisa ser recriado.
5. Repita o processo no vault final apenas depois que a amostra for aprovada.

O teste não garante que todos os espaços de trabalho se comportem da mesma forma. Ele expõe as partes do seu sistema que precisam de uma nova estrutura antes que você abandone a antiga.

Opção 1: Importar através da API do Notion

Use esta opção quando os bancos de dados e suas propriedades forem importantes. O plugin oficial Importer converte bancos de dados do Notion em pastas com um arquivo .base e converte fórmulas onde o Obsidian possui uma função equivalente.

Preparar a integração do Notion

1. Abra a página de integrações do Notion.
2. Crie uma integração interna para o espaço de trabalho.
3. Copie o segredo da integração interna para um gerenciador de senhas seguro.
4. Conceda à integração acesso às páginas e bancos de dados que deseja importar.

Nunca cole um token em artigos, histórico do terminal, issues ou notas compartilhadas. O token concede acesso a todo o conteúdo compartilhado com a integração.

Executar a importação via API

1. Abra Configurações → Plugins da comunidade no Obsidian.
2. Instale e ative o plugin oficial Importer.
3. Abra o Importer pela paleta de comandos ou pelo ícone na barra lateral.
4. Selecione Notion (API) como formato de arquivo.
5. Cole o segredo da integração e selecione Carregar (Load).
6. Escolha as páginas e bancos de dados que deseja importar.
7. Revise as opções de importação e inicie o processo.

Espaços de trabalho grandes podem levar tempo porque a API do Notion possui limites de taxa (rate limits). Importe apenas após conceder acesso às páginas pai corretas. Uma issue recente sobre páginas ausentes no Importer mostra por que o escopo de acesso e a hierarquia de páginas merecem uma verificação quando a lista de seleção parecer incompleta.

Limitações da API a considerar

A documentação oficial identifica estes limites:

• Apenas a visualização principal de cada banco de dados é importada.
• Fontes de dados vinculadas não são importadas.
• Funções de People como name() e email() não são convertidas.
• Funções de Text como style() e unstyle() não são convertidas.
• Fórmulas sem uma função equivalente no Obsidian exigem revisão manual.

Trate o arquivo .base importado como uma visualização inicial, e não como prova de que todas as visualizações do Notion foram preservadas. Verifique relações, fórmulas, filtros e os registros dos quais seu trabalho diário depende.

Opção 2: Importar uma exportação HTML do Notion

Use a importação de arquivos quando quiser um caminho sem tokens ou quando seu espaço de trabalho for composto principalmente por páginas e anexos. O Obsidian recomenda uma exportação em HTML para essa rota porque a exportação em Markdown do Notion omite dados importantes.

Exportar do Notion

1. Abra Configurações → Espaço de trabalho → Geral no Notion.
2. Selecione Exportar todo o conteúdo do espaço de trabalho.
3. Escolha HTML como formato de exportação.
4. Selecione Incluir tudo.
5. Ative Criar pastas para subpáginas.
6. Solicite ou baixe a exportação .zip.

A documentação de exportação do Notion confirma que as exportações do espaço de trabalho podem incluir arquivos HTML, Markdown, CSV e arquivos de mídia enviados. Ela também observa que as visualizações de banco de dados e alguns conteúdos não são exportados como um sistema totalmente recriável.

Importar o arquivo .zip

1. Abra o plugin oficial Importer no Obsidian.
2. Selecione Notion (.zip).
3. Escolha o arquivo exportado.
4. Selecione uma pasta de destino.
5. Ative Salvar páginas pai em subpastas se desejar manter a hierarquia.
6. Importe a exportação completa se os links internos entre as páginas forem importantes.

Esta rota traz páginas e anexos para um vault Markdown local, mas não preserva os bancos de dados do Notion como visualizações ativas. Não instale um grande conjunto de plugins antes de saber quais fluxos de trabalho precisam ser recriados.

Recrie apenas os fluxos de trabalho que você ainda usa

Um arquivo importado ainda não é um sistema funcional. Comece com a substituição mais simples para cada fluxo de trabalho ativo.

Fluxo de trabalho no Notion	Ponto de partida no Obsidian	Verificar antes de fechar o Notion
Documentos e páginas de referência	Notas Markdown, pastas, busca e links internos	Abra cinco páginas importantes e siga seus links
Banco de dados de projetos ou tarefas	Bases importadas por API, ou propriedades com visualização filtrada	Filtre por status, data de vencimento e em um projeto real
Planejamento diário	Notas diárias nativas mais um modelo	Crie a nota de hoje e confirme o modelo e a pasta
Trabalho recorrente	Plugin Tasks ou uma convenção simples de notas recorrentes	Crie, consulte e conclua uma tarefa recorrente
Reuniões e contatos	Notas de reunião vinculadas a projetos e pessoas	Encontre uma ação a partir do contexto de sua reunião e projeto
Aprovações e comentários compartilhados	Mantenha a colaboração no Notion ou em outra ferramenta de equipe	Confirme quem ainda precisa de acesso e notificações

Para um sistema local pronto para uso, o gerenciamento de tarefas do Obsibrain, o planejamento diário, os Smart Projects e as revisões periódicas cobrem as etapas da migração que geralmente exigem mais do que uma pasta com arquivos Markdown.

Se preferir construir o sistema por conta própria, comece com o método PARA no Obsidian ou uma estrutura de segundo cérebro. Adicione uma visualização de banco de dados ou plugin comunitário apenas quando houver uma necessidade real não atendida.

Checklist de aceitação da migração

Execute esta verificação antes de colocar o Notion em modo de apenas leitura ou cancelar um plano pago.

Conteúdo e links

• Todas as páginas indispensáveis existem no novo vault.
• Páginas aninhadas estão na estrutura de pastas ou links esperada.
• Links internos importantes abrem as notas corretas.
• Imagens, PDFs e outros anexos importantes abrem localmente.
• A busca encontra as páginas e propriedades que você usa semanalmente.

Dados e visualizações

• As linhas dos bancos de dados importantes para o trabalho atual existem.
• As propriedades têm os nomes e tipos esperados.
• As relações apontam para as notas corretas ou possuem uma alternativa documentada.
• Fórmulas e rollups possuem uma substituição testada ou uma limitação registrada.
• A visualização principal de projetos, tarefas ou contatos atende ao seu propósito.

Uso diário e encerramento

• Uma nova nota diária é salva na pasta correta com o modelo adequado.
• Uma tarefa pode ir da captura à conclusão sem duplicação.
• Uma ação de reunião permanece conectada ao seu contexto de origem.
• O vault possui backup e um plano de sincronização para múltiplos dispositivos.
• O Notion permanece disponível até que o checklist seja aprovado no uso diário.

Guia de solução de problemas

Sintoma	Primeiras verificações	Ação prática
A importação via API não exibe páginas ou bancos	Acesso da integração e compartilhamento das páginas pai	Compartilhe a página pai correta, recarregue a seleção e teste um escopo menor
Um banco de dados chega sem a visualização esperada	Limites da visualização principal e fontes vinculadas	Recrie a visualização ausente no Bases, ou mantenha esse fluxo no Notion
Uma fórmula não se comporta da mesma maneira	Se o Obsidian possui uma função equivalente	Conserve o resultado como uma propriedade e documente a fórmula original
A importação HTML apresenta formatação quebrada	Formato de exportação e caminhos dos anexos	Use HTML, mantenha a exportação intacta e repare primeiro as notas de maior valor
O vault parece desorganizado após a importação	Se a migração copiou um arquivo em vez de um fluxo de trabalho	Arquive o material antigo e estruture o vault ao redor das notas que você ainda usa

O rastreador de issues do Obsidian Importer é o local ideal para conferir problemas conhecidos e casos específicos.

Recomendação final

Escolha a importação via API para um espaço de trabalho focado em bancos de dados. Escolha a importação HTML para uma migração focada em páginas e sem a necessidade de tokens. Em ambos os casos, use um vault de teste, preserve a exportação original e recrie apenas os fluxos de trabalho que ainda sejam relevantes.

O objetivo não é replicar cada visualização do Notion, mas sim obter um sistema local e conectado que ajude a capturar ideias, gerenciar projetos, planejar dias e revisar compromissos. Se a configuração inicial for o principal obstáculo, utilize um sistema pronto para Obsidian; se a colaboração for o requisito principal, mantenha essa parte em uma ferramenta própria para equipes.

Fontes e leituras adicionais

• Obsidian: Importar do Notion
• Notion: Exportar seu conteúdo
• Rastreador de issues do Obsidian Importer
• Issue do Obsidian Importer: páginas ou bancos de dados ausentes