Guias

Corrigindo mídias, MathJax e templates após uma importação

Ordem de investigação para imagens ausentes, fórmulas MathJax quebradas e templates com defeito depois de importar um baralho de flashcards.

Um flashcard com um ícone de imagem quebrada ao lado do mesmo cartão mostrando a imagem carregando corretamente depois da correção

Imagens ausentes, fórmulas que não renderizam e templates quebrados depois de uma importação quase sempre vêm de uma de três causas: arquivos de mídia que não viajaram junto com a exportação, uma sintaxe de fórmula que o destino renderiza de forma diferente, ou uma regra de template que o destino não aplica da mesma maneira. Verifique nessa ordem, porque corrigir a camada errada primeiro só desperdiça tempo.

Resposta curta

  • Uma imagem em branco geralmente significa que o arquivo de mídia não estava na exportação, não que a importação falhou.
  • Problemas de MathJax quase sempre são uma diferença de renderização, não dados perdidos; o texto da fórmula continua lá.
  • Templates quebrados aparecem em tipos de nota específicos, não no baralho inteiro, então isole antes de reconstruir.
  • Teste um cartão de cada tipo antes de presumir que a importação inteira tem um problema sistêmico.
  • Corrija a exportação primeiro se a mídia continuar falhando; reimportar em cima de uma exportação ruim repete o mesmo erro.

Por que a mídia falha silenciosamente durante uma migração

A frente e o verso de um cartão podem ser importados perfeitamente enquanto a imagem ou o áudio falha, porque o cartão e sua mídia são armazenados separadamente, mesmo dentro de um único arquivo de exportação. O cartão referencia um arquivo pelo nome; a mídia em si precisa viajar junto no mesmo pacote e chegar a um local que o destino realmente lê. Quando um desses vínculos quebra, o cartão ainda é importado; ele só mostra um espaço em branco onde a mídia deveria estar.

É por isso que "a importação terminou sem erro" não diz nada sobre se a mídia realmente chegou. Um importador que cria um cartão com sucesso não tem como saber que a imagem esperada não está incluída, a menos que verifique e reporte essa ausência explicitamente. A maioria não destaca essa checagem, e o peso de testar em vez de confiar em uma mensagem de sucesso acaba sendo seu.

Corrigindo imagens e áudios ausentes

Comece confirmando se a mídia realmente foi incluída no que você exportou, não apenas no que você importou.

  1. Verifique a exportação, não só a importação. Se você foi quem criou a exportação, refaça-a marcando a opção de incluir mídia, caso seu aplicativo de origem separe essa configuração dos dados do baralho.
  2. Abra o cartão específico com mídia ausente, não apenas uma visualização em lista. Um cartão pode parecer completo em uma lista e ainda assim estar sem a imagem, porque listas em geral nem renderizam a mídia.
  3. Procure pelo nome do arquivo que o cartão referencia, se a origem e o destino exibirem esse detalhe. Um arquivo de mídia que existe sob um nome ligeiramente diferente do esperado pelo cartão falha silenciosamente ao anexar.
  4. Reexporte um baralho de teste pequeno contendo apenas o cartão com mídia ausente, com a mídia explicitamente incluída, e reimporte só esse teste. Se a mídia aparecer dessa vez, a exportação original estava incompleta, não o importador com defeito.
  5. Reanexe o arquivo manualmente como último recurso para um punhado de cartões, em vez de reimportar um baralho grande inteiro para corrigir poucos arquivos ausentes.

O áudio segue o mesmo padrão das imagens: um cartão pode aparecer normalmente e ainda assim estar sem o som, então você precisa reproduzi-lo de fato para saber. Não confie na contagem de anexos de uma tela de resumo; abra e reproduza o arquivo em si.

Corrigindo MathJax e fórmulas que não renderizam

Uma fórmula que aparece como texto puro (cifrões, barras invertidas, chaves) em vez de uma equação renderizada é um problema de exibição, não de dados perdidos. O texto de origem da fórmula quase sempre foi importado corretamente; o que está falhando é o destino interpretando essa sintaxe de forma diferente da origem.

  1. Confirme que o texto puro está lá. Abra o cartão e verifique se o texto por trás da fórmula, o MathJax ou LaTeX delimitado por cifrões, está presente, mesmo que não esteja renderizando. Se o texto está lá, é um problema de exibição que você pode corrigir sem reimportar nada.
  2. Teste uma fórmula com cada elemento que você realmente usa: um operador, uma fração, uma letra grega, um sobrescrito. Um destino pode renderizar fórmulas simples corretamente enquanto falha em uma estrutura específica de que sua coleção depende.
  3. Verifique incompatibilidades de delimitador. Ferramentas diferentes às vezes esperam marcadores levemente diferentes ao redor de uma fórmula. Se o texto puro está presente mas envolto por um delimitador que o destino não reconhece, essa incompatibilidade, e não uma fórmula perdida, é o problema real.
  4. Isole se afeta um tipo de nota ou todos eles. Uma fórmula que falha em todo cartão aponta para uma configuração de renderização geral do destino. Uma fórmula que falha em um único tipo de nota aponta para aquele template específico.

Não reescreva fórmulas manualmente em um baralho grande antes de confirmar que o texto original está intacto. Corrigir uma configuração de renderização uma vez é bem menos trabalho do que redigitar manualmente equações que nunca foram realmente perdidas.

Corrigindo templates e estilos quebrados

Um template controla como os campos de um cartão são organizados e estilizados, não o conteúdo dos campos em si, e é por isso que um cartão "quebrado" muitas vezes ainda tem todas as informações corretas escondidas dentro de um layout mal exibido.

  1. Inspecione um cartão comum primeiro, depois um cartão que você sabe que usa formatação incomum. Se ambos parecerem errados, o problema provavelmente é geral do destino. Se só o incomum parecer errado, o problema é específico das regras personalizadas daquele template.
  2. Verifique o CSS ou estilo personalizado separadamente do conteúdo do cartão. Uma regra de estilo que referencia uma fonte ou classe que o destino não reconhece pode distorcer o layout de um cartão enquanto o conteúdo real de cada campo permanece correto e pesquisável.
  3. Compare a posição dos campos, não só a aparência. Um campo que foi parar na posição errada do cartão é um problema de mapeamento entre tipos de nota, não de perda de dados; o texto geralmente ainda existe em algum lugar do cartão.
  4. Decida o que vale a pena reconstruir. Uma diferença de estilo cosmética com a qual você consegue conviver não precisa de correção. Um layout que esconde um campo que você realmente precisa ver, sim.

Um teste repetível de seis cartões para pegar isso antes que se espalhe

Rode este teste em uma amostra pequena antes de presumir que a importação inteira está boa ou quebrada.

  1. Um cartão de texto simples, sem mídia nem formatação.
  2. Um cartão com imagem.
  3. Um cartão com áudio.
  4. Um cartão cloze.
  5. Um cartão com fórmula.
  6. Um cartão usando seu template ou CSS mais personalizado.

Abra cada um individualmente, não a partir de uma visualização em lista, e confirme que a mídia carrega, a fórmula renderiza e o layout corresponde ao esperado. Esse conjunto de seis cartões pega as camadas mais propensas a quebrar separadamente, então uma falha diz exatamente com qual das três causas acima você está lidando, em vez de deixar você adivinhando em um baralho inteiro.

Para a lista de verificação mais ampla de pré-migração à qual este teste pertence, veja mova seus flashcards sem começar do zero. Para entender o que uma exportação em pacote pode e não pode carregar, veja o que um .apkg mantém do seu agendamento.

Como o StudyDaily lida com mídias e templates importados

O StudyDaily mantém a formatação dos cartões importados intacta, incluindo a formatação cloze e a exibição de oclusão de imagem, e lê a mídia referenciada por importações de .apkg e pacotes de coleção. Se um arquivo de mídia específico não estava incluído na exportação de origem, o StudyDaily não consegue recuperar um arquivo que nunca foi enviado; essa limitação pertence à exportação, não ao importador, e é exatamente por isso que testar a própria exportação é o primeiro passo de investigação acima, não o último.

Abra o StudyDaily no navegador para testar uma importação com sua própria amostra de seis cartões antes de comprometer uma coleção completa; a revisão não exige conta, então você pode verificar mídias e fórmulas antes de decidir qualquer outra coisa.

O que você deve fazer agora?

Rode o teste de seis cartões em uma amostra pequena, classifique a falha entre mídia, fórmulas ou templates, e corrija essa camada específica em vez de reimportar a coleção inteira esperando que o resultado mude.

  • Abra os cartões individualmente; visualizações em lista escondem mídia ausente.
  • Confirme que o texto da fórmula está presente antes de presumir que foi perdido.
  • Isole se um problema de layout é geral do destino ou específico de um template.
  • Refaça a exportação incluindo a mídia antes de culpar o importador.
  • Mantenha a amostra de seis cartões como seu teste padrão para futuras importações.

Perguntas frequentes

Por que minhas imagens estão ausentes depois de importar um baralho?

Quase sempre porque o arquivo de mídia não foi incluído na exportação, não porque a importação falhou. Reexporte incluindo a mídia explicitamente e teste novamente no mesmo cartão antes de presumir qualquer outro problema.

Por que o MathJax não renderiza depois da importação?

O texto puro da fórmula geralmente foi importado corretamente; o destino está renderizando essa sintaxe de forma diferente ou usando um delimitador diferente. Verifique se o texto original está presente antes de reescrever qualquer coisa manualmente.

Como sei se um problema de template afeta o baralho inteiro ou um único tipo de nota?

Compare um cartão comum com um cartão que usa seu template mais personalizado. Se só o personalizado parecer errado, o problema é específico do estilo daquele template, não da importação como um todo.

Devo reimportar o baralho inteiro para corrigir um problema de mídia?

Só depois de confirmar que a exportação agora inclui a mídia ausente. Reimportar sem corrigir a exportação primeiro reproduz a mesma lacuna, já que o importador não consegue anexar um arquivo que nunca foi enviado.

Fontes usadas neste guia

Este guia descreve a mecânica geral de exportação e importação de baralhos empacotados; o manual oficial de exportação do Anki e o manual de importação de baralhos empacotados documentam como mídia e formatação viajam dentro de um pacote naquele aplicativo específico. O comportamento de importação do StudyDaily vem do próprio registro de recursos do produto, conferido em relação a essas fontes para a data de publicação deste guia, 6 de julho de 2026.


Anki é uma marca registrada de seu respectivo proprietário. O StudyDaily não é afiliado ao Anki, não é endossado por ele nem é patrocinado por ele. O nome do produto é usado aqui apenas para descrever compatibilidade e comparar recursos.

Teste o método com seus próprios cartões

Abra o StudyDaily no navegador. O estudo local não exige uma conta.

Abrir o StudyDaily

Julien desenvolve o StudyDaily e confere cada guia com fontes primárias e o produto publicado.

Ler o método editorial

Todos os guias