Repository files navigation

• Example
  • Schema
• Reference
  • Levels
  • Parts of Speech
• Sources
• Community
  • Contributing
  • Donations
    • How can I donate?
• License

This project is an attempt to provide complete vocabulary lists for the HSK tests (Hanyu Shuiping Kaoshi - 汉语水平考试) for the Chinese language, both the previous version (2.0) and the newer one (3.0).

The data is presented in different files.

The main file -complete.json - features ALL words appearing in any level, either of the HSK 2.0 tests or the HSK 3.0 ones - thus, it's the complete list.

Each entry includes different types of information:

  {"simplified" :"爱好","radical"    :"爫","level"      : ["new-1","old-3" ],"frequency"  :4902,"pos"        : ["n","v" ],"forms"      : [ {"traditional"    :"愛好","transcriptions" : {"pinyin"    :"ài hào","numeric"   :"ai4 hao4","wadegiles" :"ai⁴ hao⁴","bopomofo"  :"ㄞˋ ㄏㄠˋ","romatzyh"  :"ay haw" },"meanings"       : ["to like; to be fond of; to take pleasure in; to be keen on","interest; hobby" ],"classifiers"    : ["个" ] } ] }

• simplified: (→s) corresponds to the main word/entry in Simplified Chinese characters (简化字)
• radical: (→r) the mainradical (部首)
• level: (→l) includes information about the HSK levels in which the word in question appears (in the above example, it's new HSK 1, and the old HSK 3) - see below for reference. ⬇️
• frequency: (→q) the word's relative "frequency" ranking (the lower this number, the more common the word)
• pos: (→p) the different parts of speech the word corresponds to (if available) - see below for reference. ⬇️
• forms: (→f) the different "forms" of the word
  • traditional: (→t) corresponds to the main word in Traditional Chinese characters (正體字)
  • transcriptions: (→i) different transliterations/transcriptions
    • pinyin: (→y) theHanyu Pinyin (汉语拼音) romanization with tone marks
    • numeric: (→n) same as above, only with numeric notation for the tones
    • wadegiles: (→w) transliteration of the word inWade-Giles (威翟式拼音)
    • bopomofo: (→b) transliteration of the word inBopomofo/Zhuyin (注音)
    • romatzyh: (→g) transliteration of the word inGwoyeu Romatzyh (国语罗马字)
  • meanings: (→m) a list of dictionary definitions for the current words (💡 all meanings have been cleaned and sanitized - as much as possible - with the possible classifier annotations extracted and presented as a separate entry)
  • classifiers: (→c) the list ofmeasure words (classifiers) associated with the word form in question (if any)

• Old HSK wordlists:https://github.com/clem109/hsk-vocabulary
• New HSK wordlists:https://github.com/elkmovie/hsk30
• Dictionary definitions:https://www.mdbg.net/chinese/dictionary (CC-CEDICT)
• Radicals:https://github.com/skishore/makemeahanzi (dictionary.txt)
• Frequency data:https://github.com/krmanik/HSK-3.0-words-list
• Parts of speech analysis:
  • http://crr.ugent.be/programs-data/subtitle-frequencies/subtlex-ch (SUBTLEX-CH)
  • https://github.com/hankcs/HanLP (HanLP)

In case you want to ask a question, suggest an idea, or practically anything related to this project - feel free! Everything and everyone is welcome.

If you notice anything wrong with any of the wordlists, or have an idea/question/whatever, feel free toopen an issue ormake a pull request. Don't even hesitate! 😉

Given that this project (along withmany others - most importantly, theArturo programming language) is maintained in my own free time, if you think it's useful, you'd be more than welcome to donate and ... help me focus on open-source work thatreally matters. :-)

There are different options:

• GitHub Sponsors
• Bitcoins

MIT License

Copyright (c) 2025 Yanis Zafirópulos (aka Dr.Kameleon)

Permission is hereby granted, free of charge, to any person obtaining a copyof this software and associated documentation files (the "Software"), to dealin the Software without restriction, including without limitation the rightsto use, copy, modify, merge, publish, distribute, sublicense, and/or sellcopies of the Software, and to permit persons to whom the Software isfurnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in allcopies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS ORIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THEAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHERLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THESOFTWARE.