Você quer mover seu grafo do Roam Research para o Notion sem perder as conexões entre suas anotações. O Roam Research usa links bidirecionais e referências de bloco que não mapeiam diretamente para a estrutura de banco de dados do Notion. Este artigo explica as etapas exatas para exportar seu grafo Roam, transformar os dados em um formato compatível com o Notion e importá-los de modo que os backlinks permaneçam funcionais como referências vinculadas. Você também aprenderá a verificar se os links sobreviveram à migração.
Principais Conclusões: Importando Roam Research para o Notion com Backlinks Intactos
- Roam Research > Exportar Todas as Páginas como Markdown: Exporta seu grafo com texto simples e [[wiki links]] que podem ser analisados.
- Ferramenta de conversão Markdown para Notion: Transforma os [[wiki links]] do Roam na sintaxe de menção de página do Notion ([[Nome da Página]]).
- Importação do Notion > Markdown e CSV: Aceita os arquivos convertidos e cria automaticamente referências vinculadas entre as páginas.
Como os Links do Roam Research Diferem dos Links do Notion
O Roam Research armazena conexões como referências em nível de bloco. Quando você digita [[Nome da Página]], o Roam cria um link bidirecional que aparece tanto na página de origem quanto na seção de referências vinculadas da página de destino. O Notion usa menções de página ([[Nome da Página]]) dentro do conteúdo da página do banco de dados ou em texto inline, e exibe backlinks na seção “Referências Vinculadas” da página de destino. A principal diferença é que o Roam pode vincular a blocos individuais, enquanto o Notion vincula apenas a páginas inteiras. Para preservar os backlinks durante a migração, você deve converter as referências de bloco do Roam em menções no nível da página e garantir que cada [[wiki link]] aponte para uma página que exista na importação.
O que se Perde e o que Permanece
As referências de bloco do Roam (por exemplo, ((block-id))) não têm equivalente no Notion. Elas serão removidas durante a conversão, a menos que você as substitua manualmente por menções de página. As referências de tag do Roam (por exemplo, #tag) podem ser convertidas em menções de página do Notion se você criar uma página para cada tag. As notas diárias no Roam se tornam páginas individuais do Notion. Atributos (por exemplo, Atributo:: Valor) podem ser armazenados como propriedades do banco de dados do Notion se você escolher um formato de importação estruturado como CSV. Os links bidirecionais principais entre páginas, no entanto, sobrevivem à conversão se você usar a ferramenta correta.
Etapas para Exportar e Converter Seu Grafo Roam
- Exportar todas as páginas do Roam Research
No Roam, vá ao menu superior direito (três pontos) e selecione Export All. Escolha “Markdown” como formato e “Include all pages” como escopo. O Roam baixará um arquivo ZIP contendo um arquivo .md por página, além de um arquivo EDN. Os arquivos .md contêm [[wiki links]] que referenciam outras páginas. - Descompactar o export e inspecionar a estrutura de arquivos
Extraia o ZIP para uma pasta. Você verá uma pasta chamada “pages” com todos os arquivos .md. Abra qualquer arquivo .md para confirmar que os links aparecem como [[Nome da Página]] sem formatação extra. Se você vir ((block-id)), essas referências serão removidas na próxima etapa. - Usar uma ferramenta de conversão para transformar os links
Abra uma ferramenta como Roam-to-Notion (roam-to-notion.netlify.app) ou um script Python local como roam-to-notion-converter. Carregue toda a pasta “pages”. A ferramenta analisará cada [[wiki link]] e gerará um arquivo CSV onde cada linha representa uma página com uma coluna “Name” e uma coluna “Content”. O conteúdo terá a sintaxe [[Nome da Página]] que o Notion entende. Referências de bloco e marcação não suportada são removidas. - Baixar o arquivo CSV convertido
Após o processamento, a ferramenta fornece um único arquivo CSV. Abra-o em um editor de texto para verificar se a primeira linha contém cabeçalhos como “Name” e “Content”. Cada linha subsequente deve ter um nome de página e seu texto corporal com [[menções]].
Importar o CSV Convertido para o Notion
- Criar uma nova página no Notion para a importação
Abra o Notion e crie uma nova página vazia. Dê a ela um título como “Importação Roam”. Esta página conterá o banco de dados importado. - Escolher Importar no menu da página
Clique no menu de três pontos no canto superior direito da nova página. Selecione Import e depois escolha CSV. O Notion abrirá um seletor de arquivos. - Selecionar o arquivo CSV convertido
Localize o arquivo CSV da ferramenta de conversão e selecione-o. O Notion exibirá uma prévia mostrando as colunas “Name” e “Content”. - Configurar as opções de importação
Na caixa de diálogo de importação, certifique-se de que a coluna “Name” esteja mapeada para o título da página. A coluna “Content” deve ser mapeada para o corpo da página. Deixe as outras configurações nos padrões. Clique em Import. - Aguardar o Notion processar a importação
Dependendo do número de páginas, isso pode levar alguns minutos. O Notion criará uma página de banco de dados por linha. Cada página terá seu título e texto corporal com [[menções]]. - Verificar se os backlinks aparecem
Abra qualquer página importada e role até o final. Você deve ver uma seção “Referências Vinculadas” listando páginas que mencionam esta página. Se não houver referências, os [[wiki links]] podem ter sido digitados incorretamente ou o nome da página de destino não corresponde exatamente.
Se a Importação do Notion Falhar ou Links Estiverem Faltando
CSV convertido mostra conteúdo em branco
A ferramenta de conversão pode ter removido todo o conteúdo se sua exportação do Roam continha tipos de bloco não suportados, como blocos de código com caracteres especiais. Reexporte do Roam usando “Markdown” e certifique-se de não incluir CSS personalizado ou scripts. Execute a conversão novamente.
Backlinks apontam para a página errada
O Notion corresponde menções de página pelo título exato da página. Se seu grafo Roam usava espaços à direita ou pontuação nos nomes das páginas, a ferramenta de conversão pode tê-los preservado. Edite o arquivo CSV em uma planilha e corte os valores da coluna “Name”. Reimporte.
Referências de bloco ((block-id)) não foram convertidas
As referências de bloco do Roam não têm equivalente no Notion. A ferramenta de conversão as remove. Para preservar a informação, copie o conteúdo do bloco referenciado para a página de origem manualmente antes de exportar. Alternativamente, use um script que substitua ((block-id)) pelo texto do bloco durante a conversão.
Exportação do Roam Research vs Importação do Notion: Diferenças de Formato
| Item | Exportação do Roam Research | Importação do Notion |
|---|---|---|
| Formato de arquivo | Markdown (.md) e EDN | CSV ou Markdown |
| Sintaxe de link | [[Nome da Página]] e ((block-id)) | [[Nome da Página]] apenas |
| Referências de bloco | Preservadas como ((id)) | Não suportadas |
| Tags | #tag | Convertidas para [[tag]] se a página de destino existir |
| Atributos | Atributo:: Valor | Perdidos a menos que use CSV com colunas |
Agora você pode mover seu grafo do Roam Research para o Notion mantendo os backlinks que conectam suas anotações. Após a importação, abra algumas páginas e confirme se a seção de Referências Vinculadas mostra as menções esperadas. Para refinar a estrutura, considere agrupar páginas relacionadas em bancos de dados do Notion com propriedades personalizadas. Para um fluxo de trabalho mais avançado, use a API do Notion para verificar programaticamente se cada [[menção]] resolve para uma página existente.