Guia de migração - roam research para anki

Como migrar do Roam Research para o Deckbase

A estrutura por blocos do Roam contém notas atômicas prontas para revisão, mas a sintaxe de [[links]] e a indentação aninhada exigem limpeza antes da importação. Este fluxo converte seu grafo do Roam em flashcards limpos sem perder as conexões que tornam o Roam útil.

Deckbase7 min de leitura

Quando usar este fluxo de trabalho

Usuários do Roam Research com notas diárias, notas de literatura ou mapas de conceito que querem converter blocos de alto sinal em um ciclo dedicado de repetição espaçada em vez de reler o grafo.

Trate isto como um processo operacional de migração, não apenas como um upload de arquivo único. O objetivo não é só ter uma importação bem-sucedida, mas também melhorar a consistência das revisões e reduzir o esforço de manutenção dos cartões nas semanas após a troca.

Checklist antes da importação

  • Identifique quais páginas têm conteúdo que vale revisar: nem toda página do Roam precisa de cartões.
  • Exporte as páginas desejadas como arquivos Markdown pela função Export All do Roam.
  • Decida se vai manter os [[links de página]] como contexto no campo de notas ou removê-los por completo.

Se um item da checklist falhar, corrija-o antes da importação. Limpar os dados na origem é mais rápido do que corrigir centenas de cartões após a migração.

Mapeamento de campos recomendado

Texto do bloco (limpo)

Campo no Deckbase
Frente ou verso do cartão
Observações
Remova [[colchetes]], #tags e ^block-refs

Contexto do bloco pai

Campo no Deckbase
Campo de notas
Observações
Preserva a âncora conceitual sem poluir o cartão

#flashcard or #card tag

Campo no Deckbase
Tag do deck
Observações
Use marcação consistente no Roam para filtrar a exportação

Título da página

Campo no Deckbase
Nome do deck
Observações
Uma página por deck mantém a carga de revisão previsível

Mantenha os mapeamentos estáveis entre decks relacionados. Uma estrutura consistente melhora as operações em lote e torna edições de modelos mais seguras depois.

Fluxo de migração passo a passo

  1. 1
    Marque no Roam os blocos que você quer como flashcards usando uma tag consistente, como #flashcard ou #review.
  2. 2
    Exporte a página ou o grafo inteiro como Markdown: o Roam gera um arquivo .md por página.
  3. 3
    Faça uma busca e substituição para remover [[colchetes duplos]], ^block-refs e #tags do texto dos blocos.
  4. 4
    Reformate os blocos marcados em pares frente/verso numa planilha: pergunta em uma linha, resposta na seguinte.
  5. 5
    Importe o CSV limpo no Deckbase, mapeando as colunas de frente/verso e adicionando o título da página como nome do deck.
  6. 6
    Revise um piloto de 20 cartões para avaliar a qualidade: reescreva blocos que eram notas atômicas mas não verdadeiras perguntas de recuperação.

Erros comuns e correções

[[Links]] não removidos antes da importação

Faça uma busca e substituição global removendo os [[...]]; mantenha o texto do link se ele for útil como contexto.

Blocos aninhados importados como um único cartão longo

Achate os filhos indentados em cartões separados durante a formatação na planilha: um fato por cartão.

Notas diárias têm conteúdo demais de baixo sinal

Exporte apenas páginas em que você marcou blocos explicitamente; ignore páginas de notas diárias brutas.

Referências de bloco (^abc123) aparecem no texto do cartão

Substitua ou remova as âncoras ^block-refs durante a etapa de busca e substituição.

Use um deck piloto pequeno após cada correção. Se a qualidade do piloto se mantiver, aplique o mesmo padrão de correção ao lote completo.

Verificações de qualidade em exemplos de saída

  • Frente: Qual é a unidade central de informação do Roam? | Verso: O bloco: um parágrafo atômico que pode ser referenciado em qualquer lugar do grafo.
  • Frente: Defina a 'nota de literatura' no Zettelkasten. | Verso: Um resumo processado do material de origem com suas próprias palavras, vinculado a notas permanentes.
  • Frente: O que o FSRS otimiza em relação ao SM-2? | Verso: Estimativas adaptativas de estabilidade de memória por cartão, em vez de fatores de facilidade fixos.

Durante o controle de qualidade, verifique cada cartão de exemplo quanto à clareza, à atomicidade e à precisão da resposta. Evite importar cartões que testem apenas a redação sem testar a compreensão.

Um teste prático: se você consegue responder com precisão em menos de 10 segundos durante a revisão, o cartão geralmente está bem delimitado. Se não, divida-o ou reescreva-o.

Perguntas frequentes

Preciso sair do Roam para usar o Deckbase?

Não. A maioria dos usuários mantém o Roam para anotações e captura, e usa o Deckbase para revisão diária dedicada. Exporte os blocos que quer memorizar, importe uma vez e mantenha seu fluxo no Roam intacto para todo o resto.

Posso automatizar a exportação do Roam para o Deckbase?

Sim. Se você tem a integração MCP do Deckbase, pode criar cartões por script diretamente a partir de exportações processadas do Roam usando a API. Para migrações pontuais, o caminho manual via CSV é mais rápido para a maioria dos usuários.

Devo importar todo o meu grafo do Roam?

Não. Importe apenas blocos marcados explicitamente para revisão. Importar o grafo inteiro produz majoritariamente cartões de baixa qualidade e uma fila de revisão impossível de gerenciar. Seja seletivo: qualidade acima de cobertura.

Transforme seus blocos do Roam em cartões de revisão diária

Comece com uma página de alto sinal, importe como deck piloto e valide a qualidade dos cartões antes de migrar o grafo inteiro.

Começar migraçãoVer todos os guias de importação

Dica: para fluxos de trabalho avançados, mantenha sua exportação original como backup e registre cada tentativa de migração pelo nome do lote e pela data.

Intenção de busca visada: roam research para anki. Este guia é revisado como uma página prática de fluxo de migração, não como um artigo informativo genérico.