MarkdownノートをDeckbaseにインポートする方法

このワークフローを使う場面

Markdownベースのノート管理を使っていて、ノートを読み返すのをやめ、手作業でカードを作らずにアクティブリコールを始めたい学習者向けです。

これは単発のファイルアップロードではなく、運用としての移行プロセスとして捉えてください。目的はインポートを成功させることだけではなく、切り替え後の数週間で復習の一貫性を高め、カード保守の負担を減らすことです。

インポート前チェックリスト

• ノートの見出しレベルが統一されている（トピックにH1/H2、問いかけにH3など）。
• 箇条書きが、質問と回答、または用語と定義の明確なパターンになっている。
• tagsやsourceなどのfrontmatterフィールドがファイル間で一貫している。

チェックリストの項目が1つでも失敗したら、インポート前に修正してください。移行後に数百枚のカードを修復するより、事前のクリーンアップのほうが速く済みます。

ステップごとの移行フロー

1. 1
   MarkdownのVaultを確認し、見出しやリストの構造が明確なファイルを選びます。
2. 2
   frontmatterのキー（tags、source、topic）を統一し、Deckbaseがカードのメタデータにマッピングできるようにします。
3. 3
   Markdownファイルをインポートし、見出しがカードの表面、箇条書きの内容が裏面になっていることを確認します。
4. 4
   20枚のカードを抜き取り確認し、見出しから問いかけへの再現性をチェックして、あいまいな問いかけは編集します。
5. 5
   毎日の復習を開始し、最初の1週間で範囲が広すぎると分かったカードは復習から外します。

よくあるエラーと対処

各修正の後に小さなパイロットデッキで試してください。パイロットの品質が保てれば、同じ修正パターンをバッチ全体に適用します。

出力品質チェックの例

• 表面: Markdownで`#`記号は何を表しますか？ | 裏面: 見出しレベルの指標（H1からH6）です。
• 表面: ノートファイルにおけるfrontmatterの目的は？ | 裏面: 本文の前に、タグ、日付、出典などのメタデータを保存します。
• 表面: リストベースのカードのベストプラクティスは？ | 裏面: リスト項目ごとに1つの概念にし、ネストした項目は個別のカードに分割します。

QAでは各サンプルカードについて、明確さ、1枚1概念になっているか、回答の正確さを確認してください。理解力を試さず文言だけを試すカードはインポートしないでください。

実用的なテスト: 復習中に10秒以内で正確に答えられれば、そのカードは通常適切な範囲に収まっています。答えられない場合は、分割するか書き直してください。

FAQ

関連ガイド

ヒント: 高度なワークフローでは、元のエクスポートをバックアップとして残し、各移行試行をバッチ名と日付で記録してください。