그냥 Anki에 옮기고 싶다면 .apkg부터 시작하고, 카드 필드를 직접 매핑하고 싶을 때 CSV, 데이터를 코드로 가공할 때만 JSON을 고르면 됩니다.
단어를 80개 저장해 뒀다. 이제 Anki로 옮기려는데 .apkg, CSV, JSON이 동시에 보인다. 공부하려고 했지 파일 포맷 월드컵을 열려고 한 건 아니다. 결론부터 말하면, 가장 단순한 출발점은 .apkg다. 카드 필드를 직접 만지고 싶을 때만 CSV 작업실로 들어가고, JSON은 코드로 가공할 사람의 서버실에 가깝다.
30초 선택: 나는 어떤 형식을 써야 할까?
| 하고 싶은 일 | 먼저 고를 형식 | 이유 |
|---|---|---|
| 저장한 항목을 최대한 빨리 Anki에 넣기 | .apkg | Language Reactor가 직접 Anki export 경로를 제공하고, Anki가 패키지 덱을 가져올 수 있습니다. |
| 앞면·뒷면·태그 등 카드 필드를 직접 정하기 | CSV | 내보낸 열을 Anki의 원하는 노트 필드에 직접 매핑할 수 있습니다. |
| 스크립트나 다른 앱으로 저장 데이터를 가공하기 | JSON | 구조화된 저장 항목 데이터를 코드에서 다루기 좋습니다. |
“설정하기 싫고 그냥 Anki에서 복습하고 싶어요.”
.apkg부터 쓰세요. 아래의 ‘가장 쉬운 방법’으로 바로 가면 됩니다. CSV를 먼저 건드릴 이유가 없습니다.
“카드 앞면과 뒷면을 제가 직접 설계하고 싶어요.”
CSV가 맞습니다. Language Reactor가 내보낸 여러 필드 중 필요한 것만 골라 Anki 노트 필드에 연결하세요.
“데이터를 코드로 정리하거나 다른 시스템에 넣을 거예요.”
JSON을 검토하세요. 일반적인 Anki 복습만 목적이라면 여기까지 내려올 필요는 없습니다.
가장 쉬운 방법: .apkg로 바로 Anki에 넣기
현재 Language Reactor의 공식 Export Help는 Saved Items에서 Export → Anki로 들어가 .apkg 파일을 내려받는 흐름을 안내합니다. Anki 쪽에서도 공식 Importing 문서에서 packaged Anki deck 가져오기를 지원한다고 설명합니다.
- Language Reactor에서 Saved Items를 엽니다.
- Export를 선택합니다.
- Anki 탭에서 export를 실행해
.apkg파일을 받습니다. - 다운로드한 파일을 열거나 Anki의 Import에서 해당 패키지를 선택합니다.
- 바로 전체 컬렉션을 옮기기보다 먼저 몇 장을 확인합니다.
여기까지 잘 됐다면 멈춰도 됩니다. 정말로요. 인터넷에는 “CSV를 풀고, 미디어를 옮기고, 노트 타입을 만들고…”로 시작하는 설명도 있지만, 지금 목적이 그냥 저장한 항목을 Anki에서 복습하는 것이라면 먼저 정문부터 열어 보는 게 맞습니다.
카드가 다르게 보이는 이유: 무엇을 저장했는지가 먼저다
내보내기 형식만 볼 게 아닙니다. Language Reactor는 공식 문서에서 저장 항목을 크게 Phrase, Words with context, Words without context로 구분합니다.
| 저장 유형 | 무슨 차이가 있나 | Anki로 옮길 때 생각할 점 |
|---|---|---|
| Phrase | 자막 줄 옆의 별표로 저장한 구문 | 문장 단위로 복습하고 싶을 때 쓰기 쉽습니다. |
| Word with context | 자막이나 사전 예문 안에서 저장한 단어 | 원래 만난 문맥이 함께 저장됩니다. Language Reactor는 Anki 카드로 export할 때 문맥 문장에서 표시된 단어가 빠진 형태로 제시된다고 설명합니다. |
| Word without context | words panel에서 직접 표시한 단어 | 공식 문서상 한쪽에는 번역, 다른 쪽에는 단어가 들어가는 단순한 형태입니다. |
그래서 “왜 어떤 카드는 문장이 있고 어떤 카드는 단어만 있지?”가 반드시 export 오류라는 뜻은 아닙니다. 저장할 때부터 데이터가 달랐을 수 있습니다. 새 단어를 모을 때 문맥이 중요하다면 Language Reactor의 기본 사용 안내처럼 자막이나 사전 예문 안에서 저장하는 쪽이 이후 복습에도 더 많은 맥락을 남깁니다.
CSV는 “우회법”이 아니라 카드 구조를 직접 잡는 방법
.apkg를 가져왔는데 카드 구성이 마음에 안 든다면 그때 CSV 작업실로 가면 됩니다. Language Reactor는 이 형식을 CSV라고 부르지만 공식 문서는 한 항목당 한 줄의 탭 구분 데이터라고 설명하고, Subtitle, Translation, Word, Lemma, Part of speech, Context, 오디오·이미지 파일명 등 여러 필드를 나열합니다.
Anki의 Text Files 공식 문서에 따르면 쉼표·세미콜론·탭 등으로 구분된 UTF-8 텍스트를 가져올 수 있고, 가져오는 열을 원하는 노트 필드에 매핑할 수 있습니다.
CSV가 특히 유용한 경우
- 앞면에는 단어, 뒷면에는 원문과 번역을 두고 싶다.
Lemma, 품사, 태그 같은 일부 필드만 남기고 싶다.- 기존 Anki 노트 타입에 맞춰 열 순서를 직접 정하고 싶다.
- 가져오기 전에 스프레드시트에서 불필요한 항목을 정리하고 싶다.
반대로 “그냥 외우고 싶다”면 CSV가 더 고급이라서 더 좋은 선택은 아닙니다. 제어권이 늘어나는 만큼 설정할 것도 늘어납니다.
이미지·오디오가 꼬일 때: 먼저 텍스트부터 확인하자
수동 CSV import에서 가장 쉽게 일이 커지는 지점은 미디어입니다. Anki 공식 문서는 텍스트 파일에서 이미지와 오디오를 쓰려면 관련 파일을 collection.media에 두고, 필드에서 이미지나 사운드를 Anki가 알아볼 수 있는 형태로 참조해야 한다고 설명합니다.
여기서 중요한 구분이 하나 있습니다. 이 규칙은 수동 텍스트 import를 구성할 때의 Anki 규칙입니다. 이걸 보고 “Language Reactor의 직접 .apkg export도 내가 항상 미디어 폴더를 손으로 만져야 한다”라고 결론 내리면 안 됩니다.
CSV를 열었더니 파일명 열이 줄줄 나오고 갑자기 공부 앱이 세관 신고서처럼 느껴진다면, 순서를 바꾸세요.
- 먼저 텍스트 필드만 가져옵니다.
- 앞면·뒷면·문맥이 원하는 위치에 들어오는지 확인합니다.
- 그다음 정말 필요한 카드에만 이미지·오디오 처리를 추가합니다.
한 번에 모든 걸 완벽하게 가져오려다가 아무것도 못 가져오는 것보다 훨씬 낫습니다.
JSON은 누구에게 필요한가?
Language Reactor는 공식 Export Help에서 저장 항목의 JSON 구조도 공개하고 있습니다. 단어 텍스트, 언어 코드, 번역, 태그, 학습 상태, 문맥, 오디오 정보 같은 데이터를 구조화된 형태로 다룰 수 있습니다.
하지만 JSON이 “정보가 많아 보여서 가장 좋은 export”는 아닙니다. 다음 중 하나가 아니라면 서버실 문은 닫아 둬도 됩니다.
- 직접 스크립트를 작성해 데이터를 변환한다.
- 여러 export를 자동으로 합치거나 필터링한다.
- Anki 이외의 시스템으로 구조화 데이터를 넘긴다.
Anki에서 복습하는 게 목표라면 먼저 .apkg나 CSV로 해결되는지 확인하세요.
전체를 옮기기 전에 5개 카드로 먼저 테스트
이건 Language Reactor나 Anki의 공식 규칙이 아니라, 대량 import 전에 실수를 줄이기 위한 간단한 실전 절차입니다. 저장 항목이 많을수록 먼저 작은 샘플을 확인하는 편이 안전합니다.
다섯 장이 멀쩡하면 그때 전체 export를 진행하세요. 다섯 장이 이상하면 수백 장을 다시 지우는 대신 지금 바로 형식이나 필드 매핑을 고칠 수 있습니다.
저장 → 정리 → 내보내기를 한 흐름으로 두고 싶다면
먼저 Language Reactor의 직접 .apkg export를 써 보세요. 이미 잘 되는 도구를 굳이 바꿀 이유는 없습니다.
다만 영상에서 저장한 항목을 정리하고, 필요할 때 내보내는 흐름을 한곳에서 쓰고 싶다면 FunFluen을 열어 제품을 확인해 볼 수 있습니다. FunFluen의 saved-item export는 저장된 데이터와 계정 상태에 따라 사용할 수 있는 형식이나 기능이 달라질 수 있으므로, 클릭 후 이 글과 똑같은 Anki 화면이 바로 열린다고 기대하기보다는 현재 제공되는 export 옵션을 먼저 확인하는 편이 정확합니다.
결론: 정문부터 열면 된다
Language Reactor Anki 내보내기에서 기억할 건 세 줄이면 충분합니다. 그대로 옮기기 = .apkg. 카드 구조를 직접 잡기 = CSV. 코드로 가공하기 = JSON.
처음부터 서버실까지 탐험할 필요는 없습니다. 저장한 단어가 Anki에 들어가고, 오늘 복습을 시작할 수 있다면 그게 이미 성공입니다. 파일 형식은 목적지가 아니라 운송수단입니다.
다른 영상 기반 학습 방법도 정리하고 싶다면 FunFluen 한국어 학습 가이드로 돌아가 다음 방법을 고를 수 있습니다.
공식 자료
- Language Reactor - Export Help — 저장 항목 유형과 Anki, CSV, JSON export 설명.
- Language Reactor - Get Started — 자막·사전에서 단어를 확인하고 저장하는 기본 흐름.
- Importing - Anki Manual — Anki가 지원하는 import 유형.
- Text Files - Anki Manual — 구분 텍스트, 필드 매핑, 이미지·오디오 참조 규칙.