Markdown 노트를 Deckbase로 가져오는 방법

이 워크플로를 사용해야 하는 경우

Markdown 기반 노트 시스템을 쓰는 학습자로서, 노트를 다시 읽는 대신 수동 카드 생성 없이 능동 회상을 시작하고 싶은 분을 위한 안내입니다.

이 과정은 단순한 일회성 파일 업로드가 아니라 운영 관점의 마이그레이션 절차로 다뤄야 해요. 목표는 가져오기에 성공하는 것만이 아니라, 전환 후 몇 주 동안 복습 일관성을 높이고 카드 유지 관리 부담을 줄이는 것이에요.

가져오기 전 점검 목록

• 노트의 제목 수준이 일관되어야 합니다(주제에는 H1/H2, 질문에는 H3).
• 글머리 기호 목록이 질문-답변 또는 용어-정의 패턴을 명확히 따라야 합니다.
• 태그나 출처 같은 frontmatter 필드가 파일 전반에서 일관되어야 합니다.

점검 목록 항목 중 하나라도 실패하면 가져오기 전에 먼저 해결하세요. 마이그레이션 후 수백 개의 카드를 고치는 것보다 미리 정리하는 편이 훨씬 빠릅니다.

단계별 마이그레이션 흐름

1. 1
   Markdown 보관함을 점검하고 제목이나 목록 구조가 명확한 파일을 고르세요.
2. 2
   Deckbase가 카드 메타데이터로 매핑할 수 있도록 frontmatter 키(tags, source, topic)를 표준화하세요.
3. 3
   Markdown 파일을 가져온 뒤 제목이 카드 앞면이 되고 글머리 기호 내용이 뒷면이 되는지 확인하세요.
4. 4
   카드 20개를 표본 점검해 제목이 질문으로 충실히 변환됐는지 확인하고 모호한 질문은 수정하세요.
5. 5
   매일 복습을 시작하고 첫 주에 너무 광범위하다고 판단되는 카드는 정리하세요.

자주 발생하는 오류와 해결 방법

수정할 때마다 작은 파일럿 덱으로 테스트하세요. 파일럿 품질이 유지되면 같은 수정 방식을 전체 배치에 적용하세요.

예시 결과물 품질 점검

• 앞면: Markdown에서 `#` 기호는 무엇을 뜻하나요? | 뒷면: 제목 수준 표시자(H1~H6)입니다.
• 앞면: 노트 파일에서 frontmatter의 용도는? | 뒷면: 본문 앞에 태그, 날짜, 출처 같은 메타데이터를 저장합니다.
• 앞면: 목록 기반 카드의 모범 사례는? | 뒷면: 목록 항목당 하나의 개념을 담고, 중첩 항목은 별도 카드로 나눕니다.

QA 단계에서는 각 샘플 카드가 명확한지, 원자적인지, 답이 정확한지 확인하세요. 이해도를 확인하지 않고 표현만 시험하는 카드는 가져오지 마세요.

실용적인 기준은 이거예요. 복습 중 10초 안에 정확히 답할 수 있으면 보통 카드 범위가 적절해요. 그렇지 않다면 카드를 나누거나 다시 작성하세요.

자주 묻는 질문

관련 가이드

팁: 고급 워크플로를 사용한다면 원본 내보내기 파일을 백업으로 보관하고, 각 마이그레이션 시도를 배치 이름과 날짜로 기록하세요.