How to Move Your Vocabulary From Anki to VocaDeck

· Giovanni Fu Lin · anki, anki-alternative, vocabulary, flashcards, migration, csv

VocaDeck does not open Anki deck files. To move over, export your notes from Anki as plain text, tidy the columns, and paste the rows into VocaDeck or drop the text file onto its paste box. Your words, readings, meanings and example sentences come across; your review history, due dates, media and card types do not. I build VocaDeck, so this guide spells out the gaps. For whether to switch at all, read VocaDeck vs Anki first.

What transfers and what does not

From AnkiIn VocaDeck
Term, reading, meaningImported
Example sentence, its reading and translationImported if in the right columns
Image as a web addressImported
Image or audio files, [sound:] tagsNot imported
Review history, intervals, ease, due datesNot imported; cards start new
Tags, deck structure, note typesNot imported
Cloze, image occlusion, other card typesNot supported by VocaDeck

The Anki side matches Anki’s documentation: its Anki Deck Package (.apkg) can include scheduling and media, but its Notes in Plain Text export writes only note fields, tab-separated, with any HTML formatting embedded in the text. Plain text is the format VocaDeck can read.

Step-by-step

  1. Export from Anki. In Anki, choose File, then Export. Select Notes in Plain Text and the deck you want. Save the .txt file. Repeat for each deck you want to move.
  2. Look at the file. Open it in a spreadsheet or text editor. Columns follow your note type’s field order. Put term first, then reading, then meaning, then example sentence, example reading, example translation. Remove columns VocaDeck has no use for, and delete any header lines beginning with # (they would be skipped and counted as invalid rows).
  3. Clean HTML and sound tags. VocaDeck’s text parser does not strip HTML or [sound:...] tags, so they would show as literal text. Find and replace them in your editor first. Anki’s own import rules are checked by the Anki import file checker, which also flags HTML.
  4. Optionally add a header row. Names like word, reading, meaning, example, example translation and image are recognised, so column order stops mattering. With no header, two columns mean term and meaning; three or more are read in the order above. A row with more columns than the header makes the whole import fail, so keep them equal.
  5. Import. Open VocaDeck, paste the rows into the vocabulary box (tab or comma separated), or drop the text file onto it. It reports how many rows it detected and how many invalid rows it will skip, and keeps your text so you can correct it. A file must be under 8 MiB.
  6. Spot-check, then back up. Review a handful of cards, then export a backup. VocaDeck keeps progress in your browser with no automatic sync, so a backup or device transfer is how you keep it.

The CSV formatter goes the other way too: it can download a list as plain Anki text, so you are not locked in.

Honest limits

  • No scheduling carry-over. If you have years of mature cards, they all restart as new. Import in batches (a few hundred at a time) so the daily workload stays sane; the cards per day guide shows the maths.
  • Narrower than Anki. No cloze deletion, no image occlusion, no audio recording, and a fixed SM-2-style scheduler rather than configurable options.
  • Browser storage. No account sync between devices beyond backup and device transfer.
  • Pasting is limited by text. I did not verify behaviour for fields with unusual quoting; the parser rejects text with unterminated quotes rather than guessing.

FAQ

Can I keep using Anki alongside VocaDeck? Yes. Many people keep a large shared deck in Anki and use VocaDeck for new reading vocabulary.

Should I wait to finish Anki reviews first? Clear your due cards before exporting, since the history will not follow.

Does it work for languages other than Chinese? The import fields are generic (term, reading, meaning). VocaDeck supports several learning languages, but check the language you need.

FAQ

Can VocaDeck import an Anki .apkg or .colpkg file?

No. VocaDeck's own Anki page says it does not import .apkg files. You export your notes from Anki as plain text, then paste the rows or drop the text file into VocaDeck.

Will my Anki review history and due dates carry over?

No. The import creates cards from the text only. Anki's package export can include scheduling, but VocaDeck has nothing that reads it, so imported cards start as new cards under VocaDeck's own SM-2-style scheduler.

What happens to my images and audio?

Audio and image files do not transfer. VocaDeck accepts an image only as a web address (or an embedded image) in the image column, and it does not read Anki's media folder or [sound:] tags.

Which fields does VocaDeck read?

Term, pronunciation, meaning, example sentence, example pronunciation, example translation and image, matched by position or by header names such as word, reading and meaning. Other Anki fields have nowhere to go.

Is there a size limit?

The text parser rejects input over 8 MiB. Progress is stored in your browser, so export a VocaDeck backup after importing.

Related project: VocaDeck