Importing into Mochi

Mochi supports several import formats to help you bring in cards from other apps, migrate existing notes, or restore material shared by others. Different formats preserve different amounts of information, so choose the one that best fits your workflow.

Importing .mochi files (native format)

A .mochi file is the native export format for Mochi and is the most complete way to import data. It preserves:

  • Review history
  • Card order
  • Templates and fields
  • Tags and metadata
  • Attachments

.mochi files are simply ZIP archives containing a JSON file and assets. This means they can be created or modified outside of Mochi by renaming:

your_file.mochi → your_file.zip

and opening the archive directly.

Use this format whenever possible, especially for backups or when sharing decks with other Mochi users.

Importing Anki .apkg files

Mochi can import Anki .apkg files, including review history. However, because Anki and Mochi work differently, imported cards may not match their original appearance exactly.

Tips for best results

Before exporting from Anki:

  • Remove unnecessary HTML
  • Remove all CSS and JavaScript
  • Simplify templates where possible

During import, Mochi strips CSS and JavaScript and converts HTML to Markdown, so cleaning the deck ahead of time helps ensure a smooth transition.

Importing Markdown files

Mochi can import Markdown as:

  • A folder of Markdown files, where each file becomes its own card
  • A single Markdown file, split into multiple cards using a delimiter you choose

Markdown imports are useful for:

  • Migrating notes from text editors
  • Bulk-creating simple cards
  • Converting plain notes into a deck

Note that Markdown imports do not preserve metadata such as review history or card order.

Importing CSV files

CSV imports allow you to create cards programmatically, through a spreadsheet application, or via an Anki export.

Importing into a deck with a template

If the deck uses a template:

  • Each column becomes a field
  • The header values determine which field each column maps to
  • You can use either the field name or field ID as the header

Example CSV file:

word,definition
猫 (ねこ),A domesticated animal often kept as a pet; a cat.
水 (みず),The liquid essential for life; water.
空 (そら),The sky; the expanse of air above the earth.
学ぶ (まなぶ),To learn or study.

Importing into a deck without a template

If the deck has no template:

  • Each column is treated as a side of the card
  • The header row is optional
  • Each row becomes a separate card

Example CSV file:

What is the capital of France?,Paris
What is photosynthesis?,The process plants use to convert sunlight into chemical energy.

CSV imports are ideal for vocabulary lists, spreadsheets, or any tabular data you want to convert into cards.