インポート後のメディア・MathJax・テンプレート崩れを直す

インポート後に画像が表示されない、数式が描画されない、テンプレートが崩れる。この3つはほぼ必ず、次のどれかが原因です。エクスポートにメディアファイルが含まれていなかった、移行先が数式の構文を違う方法で解釈している、あるいは移行先が適用するテンプレートのルールが元とは異なっている。この順番で確認してください。違う層から手をつけると、時間を無駄にします。

結論

• 画像が空白になるのは、たいていエクスポートにメディアファイルが含まれていなかったためで、インポートが失敗したわけではありません。
• MathJaxの不具合は、ほぼ常に描画の違いであり、データが失われたわけではありません。数式のテキスト自体は残っています。
• テンプレートの崩れは特定のノートタイプにだけ現れ、デッキ全体には及びません。作り直す前に切り分けてください。
• デッキ全体に問題があると決めつける前に、各タイプのカードを1枚ずつテストしてください。
• メディアが繰り返し失敗するなら、まずエクスポートを直してください。不完全なエクスポートを再インポートしても、同じ失敗が繰り返されるだけです。

メディアが移行中に静かに壊れる理由

カードの表面と裏面のテキストは問題なくインポートされるのに、画像や音声だけが失われることがあります。これは、1つのエクスポートファイルの中でも、カードとメディアが別々に保存されているためです。カードはファイル名でメディアを参照しているだけで、実際のメディアファイルは同じパッケージの中を移動し、移行先が実際に読み取れる場所に届く必要があります。どちらかのリンクが切れても、カード自体はインポートされます。ただ、メディアがあった場所が空白のまま表示されるのです。

だからこそ、「インポートがエラーなく終わった」という事実は、メディアが実際に届いたかどうかを何も保証しません。カードの作成に成功したインポーターには、想定していた画像が含まれていなかったことを知る手段がありません。明示的にチェックして報告する仕組みがなければ、気づけないのです。ほとんどのツールはそのチェックを目立つ形で示さないため、成功メッセージを信じるのではなく、自分でテストする責任があなたに残されます。

画像と音声が欠落した場合の直し方

まず、実際にインポートしたものではなく、エクスポートした時点でメディアが本当に含まれていたかを確認してください。

1. インポートではなくエクスポートを確認する。 自分でエクスポートを作成したなら、元のアプリがメディアを含めるオプションをデッキデータと分けて扱っている場合、そのオプションにチェックを入れてやり直してください。
2. メディアが欠けている該当カードを開く。 一覧画面だけでは判断しないでください。一覧はメディアそのものを描画しないことが多く、実際には欠けている画像も一見完全に見えてしまいます。
3. カードが参照しているファイル名を検索する。 元と移行先の両方でその情報を確認できる場合に有効です。カードが期待する名前とわずかに異なる名前でメディアファイルが存在すると、そのまま静かに紐付けに失敗します。
4. 欠けているカードだけを含む小さなテスト用デッキを再エクスポートする。 メディアを明示的に含めた上で、そのテストだけを再インポートしてください。今度は画像が表示されるなら、インポーター側ではなく、元のエクスポートが不完全だったということです。
5. 最終手段として、ファイルを手動で再添付する。 欠けているファイルが数枚程度なら、大きなデッキ全体を再インポートするより、手作業で直すほうが早く済みます。

音声も画像と同じパターンをたどります。カードは正常に表示されているのに、音声だけが欠けていることがあるため、実際に再生してみるまでは分かりません。サマリー画面に表示される添付ファイルの件数を信じず、必ずファイル自体を開いて再生してください。

MathJaxと数式が描画されない場合の直し方

ドルマークやバックスラッシュ、波括弧などが生の文字列のまま表示され、数式として描画されない場合、それは描画上の問題であり、データが失われたわけではありません。数式の元テキストはほぼ必ずインポートに成功しています。失敗しているのは、移行先がその構文を元と同じ方法で解釈できていないことです。

1. 元のテキストが存在することを確認する。 カードを開き、ドルマークで区切られたMathJaxやLaTeXの元テキストが存在するか確認してください。描画されていなくても、テキストさえ残っていれば、これは再インポートせずに直せる表示上の問題です。
2. 実際に使っている要素を含む数式を1つずつテストする。 演算子、分数、ギリシャ文字、上付き文字など。シンプルな数式は正しく描画されても、コレクションが依存する特定の構造だけ失敗する移行先もあります。
3. 区切り記号の不一致を確認する。 ツールによって、数式を囲む記号がわずかに異なることがあります。元テキストは存在していても、移行先が認識しない区切り記号で囲まれている場合、その不一致こそが実際のバグであり、数式が失われたわけではありません。
4. 1つのノートタイプだけの問題か、全体の問題かを切り分ける。 すべてのカードで数式が失敗するなら、移行先全体の描画設定が原因です。1つのノートタイプだけで失敗するなら、そのテンプレート固有の問題です。

元のテキストが無事だと確認する前に、大きなデッキ全体の数式を手作業で書き直さないでください。描画設定を一度直すほうが、実際には失われていない数式を1つずつ手入力し直すよりはるかに手間がかかりません。

テンプレートとスタイルの崩れを直す

テンプレートは、カードのフィールドをどう配置し、どう装飾するかを制御するものであり、フィールドの中身そのものではありません。だからこそ「崩れた」カードでも、見た目が悪いレイアウトの内側に正しい情報がそのまま隠れていることがよくあります。

1. まず通常のカードを確認し、次に特殊な書式のカードを確認する。 どちらも崩れているなら、移行先全体の問題である可能性が高いです。特殊なカードだけ崩れているなら、そのテンプレート固有のルールが原因です。
2. カスタムCSSやスタイルを、カードの内容とは分けて確認する。 移行先が認識しないフォントやクラスを参照するスタイルルールは、レイアウトを崩す一方で、各フィールドの実際の内容は正しいまま検索可能な状態で残ります。
3. 見た目だけでなく、フィールドの配置を比較する。 カードの間違った位置にフィールドが移動している場合、それはノートタイプ間のマッピングの問題であり、データが失われたわけではありません。テキストはたいてい、カードのどこかにまだ存在しています。
4. 作り直す価値があるかどうかを判断する。 我慢できる程度の見た目の違いなら直す必要はありません。ただし、本当に見る必要があるフィールドが隠れてしまうレイアウトなら、直す価値があります。

問題が広がる前に見つける、6枚のカードで繰り返せるテスト

インポート全体が正常か壊れているかを判断する前に、まず少数のサンプルでこのテストを実行してください。

1. メディアも書式もないプレーンテキストのカード
2. 画像付きのカード
3. 音声付きのカード
4. 穴埋めカード
5. 数式付きのカード
6. 最もカスタマイズしたテンプレートまたはCSSを使うカード

一覧画面ではなく、1枚ずつ個別に開いてください。そして、メディアが読み込まれること、数式が描画されること、レイアウトが想定どおりであることを確認します。この6枚のセットは、それぞれ別々に壊れやすい層を網羅しているため、失敗が起きたときに、上記3つの原因のうちどれに当たるのかが分かります。デッキ全体を推測で調べる必要はありません。

この確認が属する、より広い移行前チェックリストについては、最初からやり直さずにフラッシュカードを移行する方法をご覧ください。パッケージエクスポートがそもそも何を運べるかについては、.apkgがスケジュールの何を保持するかをご覧ください。

StudyDailyはインポートしたメディアとテンプレートをどう扱いますか

StudyDailyはインポート時にカードの書式をそのまま保ちます。穴埋めの書式や画像遮蔽の表示も含まれます。そして、.apkgとコレクションパッケージのインポートが参照するメディアを読み取ります。もし特定のメディアファイルが元のエクスポートに含まれていなかった場合、StudyDailyは一度も送られてこなかったファイルを復元することはできません。この制限はインポーター側ではなく、エクスポート側に属するものです。だからこそ、エクスポート自体をテストすることが、トラブルシューティングの最初の一歩であるべきで、最後の手段ではないのです。

ブラウザーでStudyDailyを開き、コレクション全体を持ち込む前に、自分の6枚サンプルでインポートをテストしてみてください。レビューにアカウントは不要なので、他のことを決める前にメディアと数式を確認できます。

次に何をすべきですか

小さなサンプルで6枚テストを実行し、失敗をメディア・数式・テンプレートのどれに当たるか切り分け、コレクション全体を再インポートして結果が変わることを期待するのではなく、その層だけを直してください。

• 一覧画面ではなく、カードを1枚ずつ開いてください。一覧はメディアの欠落を隠します。
• 数式が失われたと決めつける前に、元のテキストが存在することを確認してください。
• レイアウトの問題が移行先全体のものか、テンプレート固有のものかを切り分けてください。
• インポーターを疑う前に、メディアを含めてエクスポートをやり直してください。
• 今後のインポートのために、この6枚のサンプルを標準テストとして保管してください。

よくある質問

デッキをインポートした後、画像が表示されないのはなぜですか？

ほぼ常に、エクスポートにメディアファイルが含まれていなかったためで、インポートが失敗したわけではありません。メディアを明示的に含めて再エクスポートし、同じカードで再テストしてから、他の原因を疑ってください。

インポート後にMathJaxが描画されないのはなぜですか？

数式の元テキストはたいてい正しくインポートされています。移行先がその構文を違う方法で描画しているか、異なる区切り記号を使っているのです。手作業で書き直す前に、元のテキストが存在するか確認してください。

テンプレートの問題がデッキ全体に及ぶのか、1つのノートタイプだけなのか、どう見分けますか？

普通のカードと、最もカスタマイズしたテンプレートを使うカードを比較してください。カスタマイズしたほうだけ崩れているなら、その問題はインポート全体ではなく、そのテンプレートのスタイルルール固有のものです。

メディアの問題を直すために、デッキ全体を再インポートすべきですか？

エクスポート自体に、欠けていたメディアが今は含まれていると確認した後だけです。エクスポートを直さずに再インポートしても、同じ欠落が繰り返されます。一度も送られてこなかったファイルを、インポーターが添付することはできません。

このガイドで参照した情報源

このガイドは、パッケージ化されたデッキの一般的なエクスポートとインポートの仕組みを説明しています。公式のAnkiエクスポートマニュアルとパッケージ化デッキのインポートマニュアルには、そのアプリケーションにおいてメディアと書式がパッケージ内をどう移動するかが記載されています。StudyDailyのインポート動作に関する記述は、製品自体のインポーターに基づいており、このガイドの2026年7月6日の公開に合わせて、これらの情報源と照合しています。

Ankiは、それぞれの権利者が所有する登録商標です。StudyDailyはAnkiと提携、承認、またはスポンサー関係にありません。ここでは互換性の説明と機能比較のみを目的として、製品名を使用しています。