가져오기 후 미디어, 수식, 템플릿 고치기

가져오기 후 이미지가 사라지거나 수식이 렌더링되지 않거나 템플릿이 깨지는 문제는 거의 항상 세 가지 원인 중 하나에서 비롯됩니다. 내보내기에 미디어 파일이 함께 담기지 않았거나, 대상 앱이 수식 문법을 다르게 렌더링하거나, 대상 앱이 템플릿 규칙을 다르게 적용하는 경우입니다. 잘못된 층을 먼저 고치면 시간만 낭비되므로 이 순서대로 확인하세요.

결론부터

• 이미지가 비어 있다면 대개 가져오기가 실패한 것이 아니라 내보내기에 미디어 파일이 포함되지 않았다는 뜻입니다.
• MathJax 문제는 거의 항상 데이터 손실이 아니라 렌더링 차이입니다. 수식 텍스트 자체는 그대로 남아 있습니다.
• 깨진 템플릿은 덱 전체가 아니라 특정 노트 유형에서 나타나므로, 다시 만들기 전에 범위부터 좁히세요.
• 가져오기 전체에 구조적인 문제가 있다고 단정하기 전에 유형별로 카드 한 장씩 테스트하세요.
• 미디어 문제가 계속되면 내보내기부터 고치세요. 잘못된 내보내기 위에 다시 가져오기를 반복해도 같은 실패가 반복될 뿐입니다.

마이그레이션 중 미디어가 조용히 깨지는 이유

카드의 앞면과 뒷면 텍스트는 완벽하게 가져와지면서도 이미지나 오디오만 실패할 수 있습니다. 하나의 내보내기 파일 안에서도 카드와 미디어가 별도로 저장되기 때문입니다. 카드는 파일 이름으로 미디어를 참조하며, 미디어 파일 자체는 같은 패키지 안에서 함께 이동해 대상 앱이 실제로 읽는 위치에 도착해야 합니다. 둘 중 하나라도 연결이 끊어지면 카드는 그대로 가져와지지만, 원래 미디어가 있던 자리에 빈 공간만 표시됩니다.

그래서 "가져오기가 오류 없이 끝났다"는 사실만으로는 미디어가 실제로 전달됐는지 알 수 없습니다. 카드를 성공적으로 만든 가져오기 도구라도, 명시적으로 확인하고 누락을 알리지 않는 한 예상했던 이미지가 빠졌다는 사실을 알 방법이 없습니다. 대부분의 도구는 이 확인 결과를 눈에 띄게 보여 주지 않으므로, 성공 메시지를 믿기보다 직접 테스트해야 하는 부담은 여러분에게 남습니다.

누락된 이미지와 오디오 고치기

가져온 파일이 아니라 내보낸 파일에 실제로 미디어가 포함되어 있었는지부터 확인하세요.

1. 가져오기가 아니라 내보내기를 확인하세요. 내보내기를 직접 만들었다면, 원본 앱이 미디어 포함 설정을 덱 데이터와 별도로 두는 경우 그 옵션을 체크한 상태로 다시 내보내세요.
2. 목록 화면만 보지 말고 미디어가 빠진 카드를 직접 열어 보세요. 목록 화면은 미디어를 아예 렌더링하지 않는 경우가 많아서, 목록에서는 완전해 보이는 카드도 실제로는 이미지가 빠져 있을 수 있습니다.
3. 원본 앱과 대상 앱이 모두 그 정보를 보여 준다면, 카드가 참조하는 파일 이름을 검색해 보세요. 미디어 파일이 카드가 기대하는 이름과 조금이라도 다르게 존재하면 조용히 연결에 실패합니다.
4. 누락된 카드만 담은 작은 테스트 덱을 미디어 포함 옵션을 켠 채 다시 내보내고, 그 테스트만 다시 가져와 보세요. 이번에는 미디어가 나타난다면, 가져오기 도구가 아니라 원래 내보내기가 불완전했던 것입니다.
5. 소수의 카드에 대해서는 파일을 수동으로 다시 연결하는 방법을 최후의 수단으로 사용하세요. 몇 개의 누락된 파일을 고치려고 크고 복잡한 덱 전체를 다시 가져올 필요는 없습니다.

오디오도 이미지와 같은 패턴을 따릅니다. 카드가 정상적으로 표시되어도 소리는 빠져 있을 수 있으므로, 직접 재생해 봐야만 알 수 있습니다. 요약 화면의 첨부파일 개수만 믿지 말고, 파일을 직접 열어 재생해 보세요.

렌더링되지 않는 MathJax와 수식 고치기

수식이 렌더링된 형태가 아니라 달러 기호, 백슬래시, 중괄호가 그대로 보이는 원시 텍스트로 표시된다면, 이는 데이터 손실이 아니라 렌더링 문제입니다. 수식의 원본 텍스트는 거의 항상 제대로 가져와집니다. 문제는 대상 앱이 그 문법을 원본과 같은 방식으로 해석하지 못한다는 데 있습니다.

1. 원시 텍스트가 있는지 확인하세요. 카드를 열어 달러 기호로 구분된 MathJax나 LaTeX 원본 텍스트가 렌더링되지 않더라도 실제로 존재하는지 확인합니다. 텍스트가 있다면 이는 다시 가져올 필요 없이 고칠 수 있는 표시 문제입니다.
2. 실제로 사용하는 요소가 들어간 수식을 각각 테스트하세요. 연산자, 분수, 그리스 문자, 위첨자 등입니다. 대상 앱이 단순한 수식은 제대로 렌더링하면서도 컬렉션이 의존하는 특정 구조에서는 실패할 수 있습니다.
3. 구분 기호 불일치를 확인하세요. 도구마다 수식을 감싸는 표시가 조금씩 다를 수 있습니다. 원시 텍스트는 있는데 대상 앱이 인식하지 못하는 구분 기호로 감싸여 있다면, 진짜 문제는 수식이 사라진 것이 아니라 이 불일치입니다.
4. 노트 유형 하나에서만 발생하는지 전체에서 발생하는지 구분하세요. 모든 카드에서 수식이 실패한다면 대상 앱 전체의 렌더링 설정 문제입니다. 노트 유형 하나에서만 실패한다면 그 템플릿에 국한된 문제입니다.

원본 텍스트가 온전한지 확인하기 전에는 큰 덱 전체의 수식을 손으로 다시 쓰지 마세요. 애초에 사라지지 않은 수식을 일일이 다시 입력하는 것보다 렌더링 설정을 한 번 고치는 편이 훨씬 적은 작업입니다.

깨진 템플릿과 스타일 고치기

템플릿은 카드 필드의 내용이 아니라 배치와 스타일을 제어합니다. 그래서 "깨진" 카드도 잘못 표시된 레이아웃 안에 올바른 정보를 그대로 담고 있는 경우가 많습니다.

1. 먼저 일반 카드를 살펴본 다음, 특이한 서식을 쓰는 것으로 알고 있는 카드를 확인하세요. 둘 다 잘못 보인다면 대상 앱 전체의 문제일 가능성이 높습니다. 특이한 카드만 잘못 보인다면 그 템플릿의 사용자 지정 규칙에 국한된 문제입니다.
2. 사용자 지정 CSS나 스타일을 카드 내용과 별도로 확인하세요. 대상 앱이 인식하지 못하는 글꼴이나 클래스를 참조하는 스타일 규칙은 카드 레이아웃을 흐트러뜨릴 수 있지만, 각 필드의 실제 내용은 올바르게 남아 검색도 가능합니다.
3. 겉모습만이 아니라 필드 위치를 비교하세요. 필드가 카드의 잘못된 위치로 이동했다면 이는 데이터 손실이 아니라 노트 유형 사이의 매핑 문제입니다. 텍스트는 보통 카드 어딘가에 그대로 존재합니다.
4. 다시 만들 가치가 있는 것을 판단하세요. 감수할 수 있는 사소한 스타일 차이는 굳이 고칠 필요가 없습니다. 하지만 실제로 봐야 할 필드를 가리는 레이아웃은 고쳐야 합니다.

문제가 퍼지기 전에 잡아내는 반복 가능한 6장 카드 테스트

가져오기 전체가 괜찮은지 문제가 있는지 단정하기 전에, 작은 표본으로 이 테스트를 실행하세요.

1. 미디어나 서식이 없는 일반 텍스트 카드
2. 이미지가 있는 카드
3. 오디오가 있는 카드
4. 빈칸 카드
5. 수식이 있는 카드
6. 가장 많이 사용자 지정한 템플릿이나 CSS를 쓰는 카드

목록 화면이 아니라 각 카드를 개별적으로 열어 미디어가 로드되는지, 수식이 렌더링되는지, 레이아웃이 예상대로인지 확인하세요. 이 여섯 장은 따로따로 깨지기 쉬운 층을 각각 잡아내므로, 실패가 발생하면 덱 전체를 놓고 추측하는 대신 위의 세 가지 원인 중 정확히 어떤 것인지 바로 알 수 있습니다.

이 테스트가 속한 더 넓은 마이그레이션 전 점검 목록은 [[guide:move-your-flashcards-pillar|처음부터 다시 시작하지 않고 플래시카드 옮기기]]에서 확인하세요. 패키지 내보내기가 애초에 담을 수 있는 것과 없는 것은 .apkg가 일정에서 유지하는 항목에서 확인하세요.

StudyDaily는 가져온 미디어와 템플릿을 어떻게 처리하나요

StudyDaily는 빈칸 서식과 이미지 가리기 표시를 포함해 가져온 카드 서식을 그대로 유지하며, .apkg와 컬렉션 패키지 가져오기가 참조하는 미디어를 읽습니다. 원본 내보내기에 특정 미디어 파일이 포함되지 않았다면 StudyDaily도 애초에 보내지지 않은 파일을 복구할 수 없습니다. 이 한계는 가져오기 도구가 아니라 내보내기에 속하며, 그래서 위 문제 해결 순서에서 내보내기 자체를 확인하는 것이 마지막이 아니라 첫 단계인 것입니다.

전체 컬렉션을 옮기기 전에 브라우저에서 StudyDaily 열기로 직접 만든 6장 카드 표본을 가져와 테스트해 보세요. 복습에는 계정이 필요하지 않으므로, 다른 것을 결정하기 전에 미디어와 수식부터 확인할 수 있습니다.

이제 무엇을 해야 하나요?

작은 표본으로 6장 카드 테스트를 실행하고, 실패를 미디어, 수식, 템플릿 중 어디에 속하는지 분류한 다음, 결과가 달라지길 바라며 컬렉션 전체를 다시 가져오는 대신 해당 층만 고치세요.

• 카드를 개별적으로 여세요. 목록 화면은 미디어 누락을 숨깁니다.
• 수식이 사라졌다고 단정하기 전에 텍스트가 남아 있는지 확인하세요.
• 레이아웃 문제가 대상 앱 전체의 문제인지 특정 템플릿만의 문제인지 구분하세요.
• 가져오기 도구를 탓하기 전에 미디어를 포함해 내보내기를 다시 하세요.
• 앞으로 가져오기를 할 때도 6장 카드 표본을 기본 테스트로 유지하세요.

자주 묻는 질문

덱을 가져온 뒤 이미지가 사라지는 이유는 무엇인가요?

가져오기가 실패해서가 아니라 거의 항상 내보내기에 미디어 파일이 포함되지 않았기 때문입니다. 다른 문제를 의심하기 전에 미디어 포함 옵션을 켜고 다시 내보낸 뒤 같은 카드로 다시 테스트하세요.

가져온 뒤 MathJax가 렌더링되지 않는 이유는 무엇인가요?

수식의 원시 텍스트는 대개 제대로 가져와졌으며, 대상 앱이 그 문법을 다르게 렌더링하거나 다른 구분 기호를 쓰고 있는 것입니다. 직접 다시 쓰기 전에 원본 텍스트가 남아 있는지부터 확인하세요.

템플릿 문제가 덱 전체에 영향을 미치는지 노트 유형 하나에만 영향을

미치는지 어떻게 알 수 있나요?

일반 카드와 가장 많이 사용자 지정한 템플릿을 쓰는 카드를 비교하세요. 사용자 지정 카드만 잘못 보인다면, 문제는 가져오기 전체가 아니라 그 템플릿의 스타일에 국한된 것입니다.

미디어 문제를 고치려면 덱 전체를 다시 가져와야 하나요?

내보내기 자체에 누락됐던 미디어가 이제 포함됐다는 것을 확인한 뒤에만 그렇게 하세요. 내보내기를 먼저 고치지 않고 다시 가져오면 같은 공백이 그대로 재현됩니다. 가져오기 도구는 애초에 보내지지 않은 파일을 연결할 수 없기 때문입니다.

이 안내서에서 사용한 출처

이 안내서는 패키지 덱 내보내기와 가져오기의 일반적인 작동 방식을 설명합니다. Anki 공식 내보내기 매뉴얼과 패키지 덱 가져오기 매뉴얼은 그 특정 앱 안에서 미디어와 서식이 패키지 안을 어떻게 이동하는지 문서화합니다. StudyDaily의 가져오기 동작에 관한 설명은 제품 자체의 가져오기 도구에서 나온 것이며, 이 안내서의 2026년 7월 6일 발행일을 기준으로 위 출처와 대조해 확인했습니다.

Anki는 해당 소유자의 등록 상표입니다. StudyDaily는 Anki와 제휴하지 않으며, Anki의 승인이나 후원을 받지 않습니다. 여기서 제품명은 호환성을 설명하고 기능을 비교하기 위한 목적으로만 사용됩니다.