HSK Coverage Map

See at a glance how much of the official HSK vocabulary your Anki deck covers, as a map of hanzi tiles: one tile per word, grouped by level, filled in once you've reviewed it.

What it does

• Supports the HSK 2.0 (2012), HSK 3.0 (2021) and HSK 3.0 (2025) word lists, with the official per-level counts (300 / 200 / 500 / 1000 / 1600 / 1800, plus 5600 for levels 7–9 on the 2025 list).
• Each tile shows one of three states: reviewed or marked known (filled), in your deck but not reviewed yet (outlined), or not in your deck (gray). Each level panel and the headline show the percentage of reviewed words.
• Click a tile for pinyin, traditional form and meanings (CC-CEDICT), the levels it belongs to, and a button that opens the matching notes in Anki's browser. Use the arrow keys to browse words.
• Right-click a tile to mark a word you already know without an Anki card; the list is kept in a JSON file you can move outside the add-on folder.
• Cmd/Ctrl+F finds a word on the map and steps through the matches.
• A study plan pane lists every word you don't know yet, alphabetically or by frequency in books (BCC literature corpus) or in film and TV subtitles (SUBTLEX-CH), either level by level or mixed. Add cards in Anki with the map open and rows tick themselves off.
• Export the current list's coverage as JSON (copy or save) to paste into a chat with an AI for study planning.

Setup Open Tools ▸ HSK Coverage Map, pick the deck and the note field that holds the Chinese word (e.g. "Hanzi"), and the word list version. Subdecks are included. A field like "爱 (ài)" still matches 爱, and traditional-character fields match too.

On first open the add-on downloads CC-CEDICT and the two word-frequency lists (about 9 MB in total) and shows the progress; after that everything works offline.

Requires Anki 2.1.50 or later. Works on macOS, Windows and Linux.

Data sources HSK word lists are the official syllabi, as compiled by MteH (https://github.com/becky82/mteh). Dictionary: CC-CEDICT, CC BY-SA 4.0. Subtitle frequencies: SUBTLEX-CH (Cai & Brysbaert 2010, PLoS ONE; CC BY). Book frequencies: BCC corpus literature channel, Beijing Language and Culture University (free to download and use; citation requested).

HSK is a trademark of Hanban / Chinese Testing International; this add-on is an independent project, not affiliated with or endorsed by them. The add-on sends no data anywhere: its only network activity is the three first-launch downloads above (from mdbg.net, ugent.be and bcc.blcu.edu.cn), and the debug log stays on your computer.

Problems or ideas Please report them on GitHub: https://github.com/mcgrath-k/anki-hsk-coverage/issues — the add-on's Options pane has a "Report a problem" button and a "Show debug log" button to attach the log.