마이그레이션 가이드 - Anki CSV 가져오기
Anki CSV를 Deckbase로 가져오는 방법
카드가 이미 스프레드시트나 내보낸 CSV 파일에 있다면, 이 워크플로로 카드를 처음부터 다시 만들지 않고 Deckbase로 빠르게 옮길 수 있어요.
이 워크플로를 사용해야 하는 경우
이 가이드는 Anki나 스프레드시트 워크플로에서 이동하면서 기존 카드 품질은 유지하고 매일 복습에는 Deckbase를 도입하려는 학습자를 위한 가이드예요.
이 과정은 단순한 일회성 파일 업로드가 아니라 운영 관점의 마이그레이션 절차로 다뤄야 해요. 목표는 가져오기에 성공하는 것만이 아니라, 전환 후 몇 주 동안 복습 일관성을 높이고 카드 유지 관리 부담을 줄이는 것이에요.
가져오기 전 점검 목록
- CSV에는 카드당 한 행이 있고 앞면과 뒷면의 열 이름이 일관되어야 해요.
- 기호와 악센트 문자가 보존되도록 파일 인코딩은 UTF-8이어야 해요.
- 나중에 정리하지 않도록 가져오기 전에 덱 이름과 태그를 정해 두세요.
점검 목록 항목 중 하나라도 실패하면 가져오기 전에 먼저 해결하세요. 마이그레이션 후 수백 개의 카드를 고치는 것보다 미리 정리하는 편이 훨씬 빠릅니다.
권장 필드 매핑
front
- Deckbase 필드
- 카드 앞면
- 중요한 이유
- 질문은 간결하고 검증 가능해야 해요
back
- Deckbase 필드
- 카드 뒷면
- 중요한 이유
- 답변에는 꼭 필요한 세부 정보만 포함해야 해요
tags
- Deckbase 필드
- 태그
- 중요한 이유
- 필터링과 집중 복습 묶음을 가능하게 해요
source
- Deckbase 필드
- 메모
- 중요한 이유
- 향후 편집을 위한 출처 맥락을 유지해요
관련된 덱끼리는 매핑을 일관되게 유지하세요. 구조가 일관되면 일괄 작업이 수월해지고 나중에 템플릿을 수정할 때도 더 안전해요.
단계별 마이그레이션 흐름
- 1CSV 헤더를 정규화해 모든 행이 같은 스키마(front, back, tags, source)를 따르도록 하세요.
- 2빈 행과 중복 카드를 제거한 다음 UTF-8 CSV로 저장하세요.
- 3Deckbase에서 가져오기를 선택하고 각 CSV 열을 대상 카드 필드에 매핑하세요.
- 4먼저 소량 미리보기 가져오기를 실행해 20~30장의 카드를 검토한 뒤 전체 파일을 가져오세요.
- 5즉시 복습 세션을 하나 시작해 실제 학습 모드에서 카드 품질을 검증하세요.
자주 발생하는 오류와 해결 방법
구분자 불일치
깨진 문자
앞면과 뒷면이 뒤바뀜
중복 카드
수정할 때마다 작은 파일럿 덱으로 테스트하세요. 파일럿 품질이 유지되면 같은 수정 방식을 전체 배치에 적용하세요.
예시 결과물 품질 점검
- 앞면: FSRS는 무엇을 최적화하나요? | 뒷면: 적응형 간격을 통한 장기 기억 회상.
- 앞면: 기회비용을 정의하세요. | 뒷면: 포기한 최선의 대안이 지닌 가치.
- 앞면: HTTP 404는 무엇을 의미하나요? | 뒷면: 서버에서 리소스를 찾을 수 없음.
QA 단계에서는 각 샘플 카드가 명확한지, 원자적인지, 답이 정확한지 확인하세요. 이해도를 확인하지 않고 표현만 시험하는 카드는 가져오지 마세요.
실용적인 기준은 이거예요. 복습 중 10초 안에 정확히 답할 수 있으면 보통 카드 범위가 적절해요. 그렇지 않다면 카드를 나누거나 다시 작성하세요.
자주 묻는 질문
여러 CSV 파일을 가져올 수 있나요?
카드는 가져오기 전에 정리해야 하나요, 후에 정리해야 하나요?
가장 안전한 마이그레이션 전략은 무엇인가요?
팁: 고급 워크플로를 사용한다면 원본 내보내기 파일을 백업으로 보관하고, 각 마이그레이션 시도를 배치 이름과 날짜로 기록하세요.
목표 검색 의도: Anki CSV 가져오기. 이 가이드는 일반 정보성 글ではなく, 실용적인 마이그레이션 워크플로 페이지로 검토됩니다.