<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Anthony</title>
    <description>The latest articles on DEV Community by Anthony (@anthony42).</description>
    <link>https://dev.to/anthony42</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4238384%2F8e298832-6b96-481a-9a3f-6bd4bf7f73a3.jpg</url>
      <title>DEV Community: Anthony</title>
      <link>https://dev.to/anthony42</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/anthony42"/>
    <language>en</language>
    <item>
      <title>HSK 3.0 vocabulary as CSV and JSON: 10,898 words, levels 1 to 9</title>
      <dc:creator>Anthony</dc:creator>
      <pubDate>Fri, 13 Nov 2026 08:08:16 +0000</pubDate>
      <link>https://dev.to/anthony42/hsk-30-vocabulary-as-csv-and-json-10898-words-levels-1-to-9-40pb</link>
      <guid>https://dev.to/anthony42/hsk-30-vocabulary-as-csv-and-json-10898-words-levels-1-to-9-40pb</guid>
      <description>&lt;p&gt;HSK is the standard Chinese proficiency exam. Its new version, HSK 3.0, has nine levels instead of six, and its word lists are published as a PDF. If you are building a flashcard app, a reader, a tokenizer test set or a frequency study, you want rows.&lt;/p&gt;

&lt;p&gt;We needed those rows for &lt;a href="https://hskstory.com/?utm_source=devto&amp;amp;utm_medium=referral&amp;amp;utm_campaign=hsk-dataset-article" rel="noopener noreferrer"&gt;HSKStory&lt;/a&gt;, where every story is checked word by word against its level's list. So we cleaned the lists once and put them on GitHub under CC BY-SA 4.0:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;&lt;a href="https://github.com/bezlant/hsk-3-vocabulary" rel="noopener noreferrer"&gt;github.com/bezlant/hsk-3-vocabulary&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  What is in it
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;File&lt;/th&gt;
&lt;th&gt;Rows&lt;/th&gt;
&lt;th&gt;Contents&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;hsk-3.0-vocabulary.csv&lt;/code&gt; / &lt;code&gt;.json&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;10,898&lt;/td&gt;
&lt;td&gt;one row per word, with the level that introduces it&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;by-level/hsk-1&lt;/code&gt; to &lt;code&gt;by-level/hsk-7-9&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;300 to 5,562&lt;/td&gt;
&lt;td&gt;the words each level adds&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;hsk-2.0-to-3.0-changes.csv&lt;/code&gt; / &lt;code&gt;.json&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;11,087&lt;/td&gt;
&lt;td&gt;every word in either standard, with old level, new level and status&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Each word has five columns:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;simplified,traditional,pinyin,level,definitions
爱,愛,ài,1,to love; to be fond of; to like; affection; to be inclined (to do sth); to tend to (happen)
八,八,bā,1,eight
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;In the JSON files &lt;code&gt;definitions&lt;/code&gt; is an array. Levels 7, 8 and 9 share one band in the syllabus, so their level value is the string &lt;code&gt;7-9&lt;/code&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  Load it
&lt;/h2&gt;

&lt;p&gt;Python, standard library only:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="n"&gt;csv&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;io&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;urllib&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;request&lt;/span&gt;
&lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="n"&gt;collections&lt;/span&gt; &lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="nc"&gt;Counter&lt;/span&gt;

&lt;span class="no"&gt;URL&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"https://raw.githubusercontent.com/bezlant/hsk-3-vocabulary/main/hsk-3.0-vocabulary.csv"&lt;/span&gt;
&lt;span class="n"&gt;text&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;urllib&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;request&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;urlopen&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;URL&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;read&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;decode&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"utf-8"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="n"&gt;words&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kt"&gt;list&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;csv&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;DictReader&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;io&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;StringIO&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="k"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;len&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;words&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;                       &lt;span class="c1"&gt;# 10898&lt;/span&gt;
&lt;span class="k"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nc"&gt;Counter&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;w&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"level"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;w&lt;/span&gt; &lt;span class="k"&gt;in&lt;/span&gt; &lt;span class="n"&gt;words&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="c1"&gt;# 7-9: 5562, 6: 1777, 5: 1579, 4: 990, 3: 493, 1: 300, 2: 197&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;JavaScript:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;url&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"https://raw.githubusercontent.com/bezlant/hsk-3-vocabulary/main/hsk-3.0-vocabulary.json"&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;words&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nb"&gt;fetch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;url&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;hsk1&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;words&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;filter&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;w&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;w&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;level&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="s2"&gt;"1"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="nb"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;hsk1&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;length&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="c1"&gt;// 300&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Why 10,898 and not 11,000
&lt;/h2&gt;

&lt;p&gt;The syllabus says 11,000. That number counts entries cumulatively, and some written forms appear more than once across levels. One row per distinct word gives 10,898.&lt;/p&gt;

&lt;p&gt;Two words will trip you up if you rebuild the cumulative lists by filtering on &lt;code&gt;level&lt;/code&gt;. 有点儿 is listed at HSK 1, but from HSK 2 upward the syllabus writes it as 有一点儿. 有时 is listed at HSK 2 and becomes 有时候 from HSK 3. The README shows how to reproduce the published cumulative lists exactly.&lt;/p&gt;

&lt;h2&gt;
  
  
  What changed from the old HSK
&lt;/h2&gt;

&lt;p&gt;The change file answers the question every learner with an old textbook asks.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Status&lt;/th&gt;
&lt;th&gt;Words&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;added&lt;/code&gt; (new in 3.0)&lt;/td&gt;
&lt;td&gt;6,094&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;same_level&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;2,350&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;moved_up&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;1,999&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;moved_down&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;455&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;removed&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;189&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;So fewer than half of the old list's words kept their level, and more than half of the new list was not in the old one at all.&lt;/p&gt;

&lt;h2&gt;
  
  
  Sources and license
&lt;/h2&gt;

&lt;p&gt;Word scope and levels come from the final HSK examination syllabus published by the Center for Language Education and Cooperation in November 2025. Pinyin and English definitions come from CC-CEDICT, with 105 entries corrected by hand where the dictionary's default sense did not match how the syllabus uses the word. CC-CEDICT is share-alike, so the dataset is CC BY-SA 4.0 too.&lt;/p&gt;

&lt;p&gt;If a definition or reading is wrong, open an issue on the repository. The same lists run the vocabulary pages on hskstory.com, so a fix there reaches learners as well.&lt;/p&gt;

</description>
      <category>opensource</category>
      <category>python</category>
      <category>javascript</category>
      <category>chinese</category>
    </item>
  </channel>
</rss>
