Como Construir um Pipeline de Importação do Notion a Partir do Obsidian com Backlinks

Você tem um vault do Obsidian com centenas de notas interligadas e backlinks. Mover essas notas para o Notion sem quebrar as conexões entre elas é difícil. O Notion não possui uma ferramenta de importação nativa que preserve os backlinks do Obsidian. Este artigo explica como construir um pipeline de importação repetível que converte seus arquivos markdown do Obsidian em páginas do Notion mantendo a estrutura de backlinks intacta.

O que o Pipeline de Importação do Obsidian para o Notion Faz e o que Você Precisa

O pipeline converte um vault completo do Obsidian em um conjunto de páginas do Notion. Ele preserva o conteúdo de cada nota e os backlinks que as conectam. O Obsidian usa links no estilo wiki como [[Nome da Nota]] para referências internas. O Notion usa menções de página que exigem um ID de página. O pipeline deve traduzir cada link wiki em uma menção de página correspondente no Notion.

Antes de começar, você precisa de um token de integração do Notion, um banco de dados do Notion onde as páginas serão criadas e um ambiente Python com as bibliotecas requests e markdown. Você também precisa do seu vault do Obsidian exportado como arquivos markdown simples. O Obsidian armazena notas em uma pasta de arquivos .md por padrão. Se seu vault usar o serviço Obsidian Sync, baixe o vault para uma pasta local primeiro.

Como os Backlinks Funcionam no Obsidian vs Notion

No Obsidian, um backlink é uma conexão bidirecional. Quando você escreve [[Nota B]] na Nota A, ambas as notas mostram um link para a outra no painel de backlinks. O Notion não possui um painel de backlinks automático. Em vez disso, você cria uma menção digitando @ e selecionando uma página. O pipeline criará essas menções nas notas importadas para que clicar em uma menção abra a página relacionada.

Limitações da Importação Nativa do Notion

A importação de Markdown integrada do Notion converte arquivos .md em páginas. Ela não analisa links wiki. Ela trata [[Nome da Nota]] como texto simples. Isso significa que todas as suas referências cruzadas do Obsidian se tornam texto não vinculado. O pipeline neste artigo resolve esse problema convertendo cada link wiki em uma menção do Notion durante o processo de importação.

Passos para Construir o Pipeline de Importação

O pipeline tem três estágios: exportar o vault do Obsidian, executar um script Python que converte cada arquivo em uma página do Notion com menções e verificar os backlinks no Notion. O script lida com a conversão e as chamadas de API automaticamente.

1. Exporte seu vault do Obsidian como arquivos markdown simples
   Abra o Obsidian. Clique em Configurações > Arquivos e Links. Confirme que a opção “Usar [[Wikilinks]]” está ativada. Isso garante que seus links usem o formato wiki. Navegue até a pasta do seu vault. Copie a pasta inteira para um novo local fora do Obsidian. Esta pasta será a entrada para o pipeline.
2. Crie uma integração do Notion e obtenha seu token de API
   Acesse https://www.notion.so/my-integrations. Clique em “Nova integração”. Dê um nome como “Importação Obsidian”. Selecione o workspace onde você importará as páginas. Clique em Enviar. Copie o token secreto de integração interna. Você usará este token no script Python.
3. Compartilhe um banco de dados do Notion com a integração
   No Notion, crie uma nova página de banco de dados. Este banco de dados armazenará todas as páginas importadas. Clique em Compartilhar no canto superior direito. Adicione sua integração digitando o nome dela. Selecione a integração e clique em Convidar. A integração agora tem permissão para criar páginas neste banco de dados.
4. Instale o Python e as bibliotecas necessárias
   Abra um terminal ou prompt de comando. Execute pip install requests markdown. Se você não tiver o Python instalado, baixe-o de python.org e instale a versão 3.8 ou posterior.
5. Escreva o script de conversão
   Crie um novo arquivo chamado obsidian_to_notion.py. O script faz o seguinte: (a) lê cada arquivo .md na pasta de entrada, (b) extrai o título da nota do nome do arquivo, (c) analisa o conteúdo markdown, (d) encontra todos os [[links wiki]] usando a regex \[\[([^\]]+)\]\], (e) substitui cada link wiki por um placeholder que inclui o título da página de destino, (f) envia cada nota para a API do Notion como uma nova página no banco de dados, (g) armazena o ID da página do Notion para cada nota importada em um dicionário, (h) após todas as páginas serem criadas, atualiza cada página para substituir os placeholders por menções reais do Notion usando os IDs de página armazenados. O script deve lidar com títulos de notas duplicados anexando um sufixo ao título da página.
6. Execute o script
   No terminal, execute python obsidian_to_notion.py. O script processará cada arquivo e exibirá mensagens de progresso. Aguarde a conclusão do script. Isso pode levar vários minutos para vaults grandes.
7. Verifique os backlinks no Notion
   Abra o banco de dados do Notion onde as páginas foram criadas. Clique em qualquer página. Procure por texto que mostre uma menção (um link azul com o ícone da página). Clique na menção. A página vinculada deve abrir. Se a menção mostrar texto simples em vez de um link, o script não encontrou o ID da página de destino. Verifique a saída do console em busca de erros sobre títulos de página ausentes.

Se o Pipeline Falhar ao Criar Menções

O destino do link wiki não existe como título de página

Se um link wiki apontar para uma nota que não foi exportada ou tem um título diferente, o script o deixará como texto simples. Para corrigir isso, certifique-se de que cada nota vinculada esteja presente na pasta de entrada. Use uma ferramenta como grep para encontrar todos os links wiki e compará-los com a lista de nomes de arquivo.

Limite de taxa da API do Notion atingido

A API do Notion permite 3 requisições por segundo por integração. Se seu vault tiver mais de 300 notas, o script pode atingir o limite de taxa. Adicione uma chamada time.sleep(0.35) entre as requisições da API no script para ficar abaixo do limite.

Menções de página aparecem como @Sem título

Isso acontece quando o script cria uma página com título vazio. Verifique se seus arquivos markdown têm um título na primeira linha. O script deve usar o nome do arquivo sem a extensão .md como título padrão. Se o arquivo começar com um cabeçalho #, o script pode usá-lo em vez disso.

Banco de dados não compartilhado com a integração

Se o script retornar um erro 403, a integração não tem acesso ao banco de dados de destino. Vá para o banco de dados no Notion, clique em Compartilhar e confirme se sua integração está listada. Se não, repita o passo 3.

Comparação entre Exportação do Vault Obsidian e Métodos de Importação do Notion

Item	Importação Nativa de Markdown do Notion	Pipeline Personalizado com API
Preservação de backlinks	Não – links wiki viram texto simples	Sim – converte para menções do Notion
Tempo de configuração	5 minutos	1–2 horas
Automação	Manual, uma vez	Repetível com script
Lida com vaults grandes	Sim, mas sem backlinks	Sim, com limitação de taxa
Requer programação	Não	Sim, Python básico

O pipeline personalizado exige mais trabalho inicial. É o único método que mantém seus backlinks do Obsidian funcionais no Notion.

Agora você pode importar um vault inteiro do Obsidian para o Notion preservando cada backlink como uma menção clicável. O script lida com a conversão automaticamente após você configurar a integração e o banco de dados. Para importações futuras, execute o script novamente na mesma pasta para atualizar páginas existentes ou adicionar novas. Para melhorar ainda mais o pipeline, adicione um recurso que detecte quando um destino de link wiki não existe e crie uma página placeholder com esse título no mesmo banco de dados.