{
 "slug": "thai-tone-rules",
 "question": "How do Thai tone rules work?",
 "method": "public-corpus",
 "checkedAt": "2026-10-26",
 "methodDetail": "The post's table (consonant class x live or dead ending x tone mark, with vowel length splitting the low-class dead cell) is applied to every single-syllable word in Phayan's word list, which is built from the Thai entries of English Wiktionary as extracted by Kaikki.org. The inputs are read from the spelling; the tone the word is said with is read from the tone numerals in the entry's IPA (˧ mid, ˨˩ low, ˥˩ falling, ˦˥ high, ˩˩˦ rising). Words whose IPA has more than one syllable are skipped. Each miss is weighted by its Thai National Corpus count (PyThaiNLP tnc_freq, as committed in the repository). The Phayan facts the post states are re-read from the plans endpoint and the files that define them.",
 "tools": {
  "python": "3.9.6",
  "libraries": "standard library only (json, re, csv, hashlib, urllib, subprocess)"
 },
 "inputs": [
  {
   "id": "word-list",
   "role": "Thai words with IPA, from English Wiktionary via Kaikki.org (CC BY-SA)",
   "file": "apps/api/src/content/seed/kaikki-enriched.jsonl",
   "sha256": "f78a08aaa45580d05c22c59d633e6bf14974c895a70dfc830803cf42cd599026",
   "commit": "0bc270d893408d7fd416c95c94b82ba7a90bdc2e",
   "upstream": "https://kaikki.org/dictionary/Thai/"
  },
  {
   "id": "tnc-frequency",
   "role": "Thai National Corpus counts for the same words, PyThaiNLP tnc_freq",
   "file": "apps/api/src/content/seed/word-frequency.jsonl",
   "sha256": "247f0d41e351031470be2af0de4f278412eb6194a43f11f8e751e0eee7e68400",
   "commit": "9f19080ba180088b8bd2aecb7f5678faf64f2631",
   "upstream": "https://github.com/PyThaiNLP/pythainlp"
  },
  {
   "id": "plans",
   "role": "Phayan web prices",
   "url": "https://api.phayan.com/subscriptions/plans"
  },
  {
   "id": "learn-access",
   "role": "Phayan free/paid boundary",
   "file": "packages/shared/src/learn-access.ts"
  },
  {
   "id": "levels",
   "role": "Phayan level titles",
   "file": "apps/api/src/content/seed/levels.ts"
  },
  {
   "id": "srs",
   "role": "Phayan review schedule",
   "file": "apps/web/src/lib/learn/srs/schedule.ts"
  },
  {
   "id": "thaipod101-tones",
   "role": "ThaiPod101's own guide to Thai tones",
   "url": "https://www.thaipod101.com/blog/2021/01/18/thai-tones/"
  },
  {
   "id": "ling-thai",
   "role": "Ling's own Thai page",
   "url": "https://ling-app.com/learn-language/thai/"
  }
 ],
 "results": {
  "corpus": {
   "words_in_list": 2249,
   "checked": 1872,
   "correct": 1840,
   "accuracy_pct": 98.29,
   "exceptions": 32,
   "marked_checked": 301,
   "marked_correct": 299,
   "marked_correct_pct": 99.34,
   "unmarked_checked": 1571,
   "unmarked_correct": 1541,
   "unmarked_correct_pct": 98.09,
   "latin_letter_names": 4,
   "loanwords": 24,
   "native_or_obsolete": 4,
   "predicted_to_actual_high": 27,
   "skipped": {
    "multi-syllable": 363,
    "no-tone-in-ipa": 1,
    "unparsed-spelling": 13
   },
   "tnc_total_of_list": 20053734,
   "tnc_of_exceptions": 311374,
   "tnc_exception_share_pct": 1.553,
   "ko_tnc_frequency": 299255,
   "ko_share_of_exception_occurrences_pct": 96.11
  },
  "exceptions": [
   {
    "word": "ก็",
    "ipa": "/kɔʔ˥˩/",
    "gloss": "too; also; then; ฉันก็ชอบ 'I like it too'; ก็ไป 'well then, let's go'",
    "consonant_class": "mid",
    "ending": "dead",
    "vowel_length": "short",
    "tone_mark": "none",
    "predicted_tone": "low",
    "actual_tone": "falling",
    "category": "native",
    "tnc_frequency": 299255,
    "share_of_exception_occurrences_pct": 96.11
   },
   {
    "word": "เมตร",
    "ipa": "/meːt̚˦˥/",
    "gloss": "metre.",
    "consonant_class": "low",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "falling",
    "actual_tone": "high",
    "category": "loanword",
    "tnc_frequency": 3325,
    "share_of_exception_occurrences_pct": 1.07
   },
   {
    "word": "เอส",
    "ipa": "/ʔeːs˦˥/",
    "gloss": "The name of the Latin script letter S/s.",
    "consonant_class": "mid",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "low",
    "actual_tone": "high",
    "category": "latin-letter-name",
    "tnc_frequency": 2405,
    "share_of_exception_occurrences_pct": 0.77
   },
   {
    "word": "เอฟ",
    "ipa": "/ʔeːf˦˥/",
    "gloss": "The name of the Latin script letter F/f.",
    "consonant_class": "mid",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "low",
    "actual_tone": "high",
    "category": "latin-letter-name",
    "tnc_frequency": 1490,
    "share_of_exception_occurrences_pct": 0.48
   },
   {
    "word": "เทป",
    "ipa": "/tʰeːp̚˦˥/",
    "gloss": "tape (medium)",
    "consonant_class": "low",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "falling",
    "actual_tone": "high",
    "category": "loanword",
    "tnc_frequency": 920,
    "share_of_exception_occurrences_pct": 0.3
   },
   {
    "word": "เอช",
    "ipa": "/ʔeːt͡ɕʰ˦˥/",
    "gloss": "The name of the Latin script letter H/h.",
    "consonant_class": "mid",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "low",
    "actual_tone": "high",
    "category": "latin-letter-name",
    "tnc_frequency": 502,
    "share_of_exception_occurrences_pct": 0.16
   },
   {
    "word": "เฟค",
    "ipa": "/feːk̚˦˥/",
    "gloss": "alternative form of เฟก (féek)",
    "consonant_class": "low",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "falling",
    "actual_tone": "high",
    "category": "loanword",
    "tnc_frequency": 402,
    "share_of_exception_occurrences_pct": 0.13
   },
   {
    "word": "แฮป",
    "ipa": "/hɛp̚˦˥/",
    "gloss": "To wish someone a happy birthday.",
    "consonant_class": "low",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "falling",
    "actual_tone": "high",
    "category": "loanword",
    "tnc_frequency": 392,
    "share_of_exception_occurrences_pct": 0.13
   },
   {
    "word": "เมรุ",
    "ipa": "/meːn˧/",
    "gloss": "Meru, the mountain that serves as the centre of the universe and the situation of the heaven ดาวดึงส์ (daao-wá-dʉng).",
    "consonant_class": "low",
    "ending": "dead",
    "vowel_length": "short",
    "tone_mark": "none",
    "predicted_tone": "high",
    "actual_tone": "mid",
    "category": "native-name",
    "tnc_frequency": 368,
    "share_of_exception_occurrences_pct": 0.12
   },
   {
    "word": "บัส",
    "ipa": "/bat̚˦˥/",
    "gloss": "bus.",
    "consonant_class": "mid",
    "ending": "dead",
    "vowel_length": "short",
    "tone_mark": "none",
    "predicted_tone": "low",
    "actual_tone": "high",
    "category": "loanword",
    "tnc_frequency": 324,
    "share_of_exception_occurrences_pct": 0.1
   },
   {
    "word": "เชฟ",
    "ipa": "/t͡ɕʰeːp̚˦˥/",
    "gloss": "chef.",
    "consonant_class": "low",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "falling",
    "actual_tone": "high",
    "category": "loanword",
    "tnc_frequency": 312,
    "share_of_exception_occurrences_pct": 0.1
   },
   {
    "word": "ซอส",
    "ipa": "/sɔːt̚˦˥/",
    "gloss": "sauce",
    "consonant_class": "low",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "falling",
    "actual_tone": "high",
    "category": "loanword",
    "tnc_frequency": 285,
    "share_of_exception_occurrences_pct": 0.09
   },
   {
    "word": "เฟส",
    "ipa": "/feːs˨˩/",
    "gloss": "phase",
    "consonant_class": "low",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "falling",
    "actual_tone": "low",
    "category": "loanword",
    "tnc_frequency": 277,
    "share_of_exception_occurrences_pct": 0.09
   },
   {
    "word": "บอส",
    "ipa": "/bɔːt̚˦˥/",
    "gloss": "boss (in a firm or video game).",
    "consonant_class": "mid",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "low",
    "actual_tone": "high",
    "category": "loanword",
    "tnc_frequency": 194,
    "share_of_exception_occurrences_pct": 0.06
   },
   {
    "word": "เซฟ",
    "ipa": "/seːp̚˦˥/",
    "gloss": "safe; secure.",
    "consonant_class": "low",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "falling",
    "actual_tone": "high",
    "category": "loanword",
    "tnc_frequency": 185,
    "share_of_exception_occurrences_pct": 0.06
   },
   {
    "word": "แมส",
    "ipa": "/mɛːt̚˦˥/",
    "gloss": "mainstream.",
    "consonant_class": "low",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "falling",
    "actual_tone": "high",
    "category": "loanword",
    "tnc_frequency": 156,
    "share_of_exception_occurrences_pct": 0.05
   },
   {
    "word": "เคส",
    "ipa": "/kʰeːs˦˥/",
    "gloss": "case (e.g. in “mobile phone case”, “case study”, etc.).",
    "consonant_class": "low",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "falling",
    "actual_tone": "high",
    "category": "loanword",
    "tnc_frequency": 146,
    "share_of_exception_occurrences_pct": 0.05
   },
   {
    "word": "ชีส",
    "ipa": "/t͡ɕʰiːs˦˥/",
    "gloss": "cheese.",
    "consonant_class": "low",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "falling",
    "actual_tone": "high",
    "category": "loanword",
    "tnc_frequency": 115,
    "share_of_exception_occurrences_pct": 0.04
   },
   {
    "word": "พีช",
    "ipa": "/pʰiːt̚˦˥/",
    "gloss": "peach (fruit)",
    "consonant_class": "low",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "falling",
    "actual_tone": "high",
    "category": "loanword",
    "tnc_frequency": 88,
    "share_of_exception_occurrences_pct": 0.03
   },
   {
    "word": "นอต",
    "ipa": "/nɔt̚˦˥/",
    "gloss": "nut (for bolts)",
    "consonant_class": "low",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "falling",
    "actual_tone": "high",
    "category": "loanword",
    "tnc_frequency": 54,
    "share_of_exception_occurrences_pct": 0.02
   },
   {
    "word": "ปราก",
    "ipa": "/praːk̚˦˥/",
    "gloss": "Prague (the capital city of the Czech Republic)",
    "consonant_class": "mid",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "low",
    "actual_tone": "high",
    "category": "loanword",
    "tnc_frequency": 48,
    "share_of_exception_occurrences_pct": 0.02
   },
   {
    "word": "มูส",
    "ipa": "/muːs˦˥/",
    "gloss": "moose.",
    "consonant_class": "low",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "falling",
    "actual_tone": "high",
    "category": "loanword",
    "tnc_frequency": 39,
    "share_of_exception_occurrences_pct": 0.01
   },
   {
    "word": "เฮก",
    "ipa": "/heːk̚˦˥/",
    "gloss": "The Hague (a city, the administrative capital of the Netherlands)",
    "consonant_class": "low",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "falling",
    "actual_tone": "high",
    "category": "loanword",
    "tnc_frequency": 21,
    "share_of_exception_occurrences_pct": 0.01
   },
   {
    "word": "เฟก",
    "ipa": "/feːk̚˦˥/",
    "gloss": "pretentious; insincere; hypocritic; phony; ingenuine.",
    "consonant_class": "low",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "falling",
    "actual_tone": "high",
    "category": "loanword",
    "tnc_frequency": 17,
    "share_of_exception_occurrences_pct": 0.01
   },
   {
    "word": "แอป",
    "ipa": "/ʔɛp̚˦˥/",
    "gloss": "application",
    "consonant_class": "mid",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "low",
    "actual_tone": "high",
    "category": "loanword",
    "tnc_frequency": 15,
    "share_of_exception_occurrences_pct": 0.0
   },
   {
    "word": "ฬ่อ",
    "ipa": "/lɔː˥˩/",
    "gloss": "obsolete form of ล่อ (lɔ̂ɔ, “mule”)",
    "consonant_class": "mid",
    "ending": "live",
    "vowel_length": "long",
    "tone_mark": "mai ek",
    "predicted_tone": "low",
    "actual_tone": "falling",
    "category": "obsolete-spelling",
    "tnc_frequency": 12,
    "share_of_exception_occurrences_pct": 0.0
   },
   {
    "word": "เอป",
    "ipa": "/ʔeːp̚˦˥/",
    "gloss": "ape.",
    "consonant_class": "mid",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "low",
    "actual_tone": "high",
    "category": "loanword",
    "tnc_frequency": 8,
    "share_of_exception_occurrences_pct": 0.0
   },
   {
    "word": "เฮช",
    "ipa": "/heːt͡ɕʰ˦˥/",
    "gloss": "The name of the Latin script letter H/h.",
    "consonant_class": "low",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "falling",
    "actual_tone": "high",
    "category": "latin-letter-name",
    "tnc_frequency": 7,
    "share_of_exception_occurrences_pct": 0.0
   },
   {
    "word": "โคช",
    "ipa": "/kʰoːt̚˦˥/",
    "gloss": "coach (a bus that travels for longer distances).",
    "consonant_class": "low",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "falling",
    "actual_tone": "high",
    "category": "loanword",
    "tnc_frequency": 5,
    "share_of_exception_occurrences_pct": 0.0
   },
   {
    "word": "ช่ะ",
    "ipa": "/t͡ɕʰaʔ˨˩/",
    "gloss": "used to check agreement.",
    "consonant_class": "low",
    "ending": "dead",
    "vowel_length": "short",
    "tone_mark": "mai ek",
    "predicted_tone": "falling",
    "actual_tone": "low",
    "category": "native",
    "tnc_frequency": 4,
    "share_of_exception_occurrences_pct": 0.0
   },
   {
    "word": "โยบ",
    "ipa": "/joːp̚˦˥/",
    "gloss": "Job: a book of the Old Testament.",
    "consonant_class": "low",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "falling",
    "actual_tone": "high",
    "category": "loanword",
    "tnc_frequency": 2,
    "share_of_exception_occurrences_pct": 0.0
   },
   {
    "word": "แกรด",
    "ipa": "/krɛːt̚˦˥/",
    "gloss": "to graduate: to leave the group or band; to resign from membership.",
    "consonant_class": "mid",
    "ending": "dead",
    "vowel_length": "long",
    "tone_mark": "none",
    "predicted_tone": "low",
    "actual_tone": "high",
    "category": "loanword",
    "tnc_frequency": 1,
    "share_of_exception_occurrences_pct": 0.0
   }
  ],
  "productFacts": [
   {
    "id": "free-levels",
    "claim": "The free path runs to level 4, where the mid class and the tone marks arrive together.",
    "file": "packages/shared/src/learn-access.ts",
    "quote": "export const FIRST_PAID_LEVEL = 5;",
    "holds": true
   },
   {
    "id": "level-4-title",
    "claim": "Level 4 is the mid class and the tone marks.",
    "file": "apps/api/src/content/seed/levels.ts",
    "quote": "title: 'Mid class + tone marks',",
    "holds": true
   },
   {
    "id": "level-3-title",
    "claim": "Finals and syllable types are their own free level before the tone marks.",
    "file": "apps/api/src/content/seed/levels.ts",
    "quote": "title: 'Finals & syllable types',",
    "holds": true
   },
   {
    "id": "srs-intervals",
    "claim": "The review schedule brings an item back at 1, 3, 7 and 21 days.",
    "file": "apps/web/src/lib/learn/srs/schedule.ts",
    "quote": "export const SRS_INTERVALS = [1, 3, 7, 21] as const;",
    "holds": true
   },
   {
    "id": "srs-mastery",
    "claim": "Three correct answers in a row mark an item as learned.",
    "file": "apps/web/src/lib/learn/srs/schedule.ts",
    "quote": "export const SRS_MASTERY_COUNT = 3;",
    "holds": true
   },
   {
    "id": "srs-reset",
    "claim": "One wrong answer restarts the ladder.",
    "file": "apps/web/src/lib/learn/srs/schedule.ts",
    "quote": "correctCount: 0,",
    "holds": true
   },
   {
    "id": "price",
    "claim": "Beyond the free levels it is $14.99 a month or $79.99 a year on the web.",
    "url": "https://api.phayan.com/subscriptions/plans",
    "quote": "\"pricing\":{\"monthly\":14.99,\"annual\":79.99,\"currency\":\"USD\"}",
    "holds": true
   }
  ],
  "pageQuotes": [
   {
    "id": "thaipod101-rules-optional",
    "party": "ThaiPod101",
    "claim": "ThaiPod101's guide to Thai tones says you don't need to fully understand these rules and exceptions to pronounce Thai tones correctly.",
    "url": "https://www.thaipod101.com/blog/2021/01/18/thai-tones/",
    "quote": "So you don’t need to fully understand these rules and exceptions to pronounce Thai tones correctly.",
    "holds": true
   },
   {
    "id": "thaipod101-children",
    "party": "ThaiPod101",
    "claim": "The same guide points out that Thai children meet the rules later.",
    "url": "https://www.thaipod101.com/blog/2021/01/18/thai-tones/",
    "quote": "When Thai children learn how to pronounce tones, they don’t learn about lessons like this until later.",
    "holds": true
   },
   {
    "id": "ling-classes-and-marks",
    "party": "Ling",
    "claim": "Ling's Thai page describes consonant classes that determine tone and tone marks that interact with those classes.",
    "url": "https://ling-app.com/learn-language/thai/",
    "quote": "consonant classes that determine tone, vowels that follow positional rules, and tone marks that interact with those classes",
    "holds": true
   }
  ]
 },
 "notes": [
  "The share columns are shares of the Thai National Corpus count of the 2,249 words in the word list, not of the whole corpus.",
  "Two misses are not the table's fault: เมรุ ends in a silent ร that the parser reads as a final, and ฬ่อ is an obsolete spelling. Both stay in the list with their gloss so a reader can judge them.",
  "Categories (loanword, Latin letter name, native) are assigned by hand from each entry's gloss; the list is in CATEGORY in check.py.",
  "Glosses are Wiktionary's, with its dash before example sentences replaced by a semicolon.",
  "Not re-run: the earlier version of the post reported a 254-word check of the leading-letter rule (88% right) and a run on 1,844 words with sub-figures of 99.7% and 98.0%. Neither was published with its word list, so both figures were removed from the post.",
  "The upstream PyThaiNLP tnc_freq file was not fetched on the check date; the counts are the repository's committed snapshot, identified by its sha256 and commit.",
  "Not checked by this script: that Phayan's audio is synthesised. That comes from the product's content profile, not from a file in this repository.",
  "Removed from the post rather than kept: that ThaiPod101 publishes the table as a chart to memorise up front and teaches tone rules on video, that an Anki deck of the table teaches the table rather than the reading, and that Ling and Drops lean on romanised prompts. None had a source. ThaiPod101's own tone guide, read on the check date, says the opposite of the first (see pageQuotes)."
 ]
}
