Skip to content
TabShedKitsMy desk

Add Furigana to Japanese Text: Check the Readings Before You Share

Updated 5 min readBy

How to add furigana to a Japanese text, which words an automatic tool often reads wrongly, and how to turn the result into ruby HTML, a vocabulary list or a hiragana-only version.

Furigana GeneratorAdd readings above kanji
Open Furigana Generator
On this page
  1. What an automatic furigana tool actually does
  2. A five-step workflow that works for a class sheet
  3. The readings that are most often wrong
  4. Using the three outputs
  5. How much furigana is right?
  6. Mixing furigana with other study tools
  7. Privacy and offline use
  8. When to use a different tool

You have a news article, a page from a novel or a set of instructions in Japanese, and the reader (a student, a child, a colleague who is still learning) cannot read all the kanji. Furigana, the small hiragana written over a kanji word, solves that. Writing it by hand takes hours. The Furigana Generator adds it in a second, but an automatic reading is only as good as the checking that follows. This guide shows the workflow, the words that go wrong most often, and the three ways to use the result.

What an automatic furigana tool actually does

A tool like this does not translate and does not understand the story. It cuts the sentence into words with a morphological analyser (here kuromoji, with the IPAdic dictionary), and for every word that contains kanji it takes the reading stored in the dictionary. That is why it is fast and why it is mostly right: common words have one common reading. It is also why it can be wrong: a word with two readings gets one of them, chosen by how likely the pair of neighbouring words is, not by what you mean.

The tool then does one more job that people forget: it splits the okurigana off. The dictionary reading of 行きます is いきます, but the furigana belongs only over the kanji, so the output is 行 with い above it, followed by きます. A tool that does not do this puts いきます over the whole word, which looks wrong and wastes space.

A five-step workflow that works for a class sheet

  1. Clean the text first. Remove page numbers, headers and line breaks in the middle of a sentence. A sentence cut in two gives the analyser less context and worse readings.
  2. Paste it into the tool, or drop a .txt file onto the left box. Text files in Shift_JIS or EUC-JP are also read; Word and PDF files are not, so copy the text out first.
  3. Read the preview against the source. Look only at kanji words you are not sure of. The list below tells you where to look first.
  4. Correct by hand in the result box. Edit the Kanji(reading) tab (the form 生(せい)) or the Ruby HTML; the tool does not learn from your corrections, so do this after you copy.
  5. Use the right output for where the text is going: ruby HTML for a web page, bracket form for a chat or a spreadsheet, hiragana only for text-to-speech.

The readings that are most often wrong

Almost every error is a word with more than one reading. These are the ones worth a second look in any text you will print or teach from.

WordPossible readingsWhat decides it
生なま, せい, い(きる), う(まれる)The word it belongs to: 生ビール (なま), 学生 (せい), 生きる (い)
行ったいった, おこなったMeaning: went, or carried out
人気にんき, ひとけPopularity or a sign of people being around
上手じょうず, うわて, かみてSkill, upper hand, stage left
今日きょう, こんにちEveryday speech or formal and fixed phrases (今日は as a greeting)
方かた, ほうPolite word for person, or a direction / side
大人おとな, たいじんAlmost always おとな
明日あした, あす, みょうにちSpoken, written or very formal

Names deserve their own check. A surname such as 小林, 長谷川 or 東 can be read in several ways, and the dictionary has no way to know which one the person uses. For names, trust the person, not the tool.

Using the three outputs

Ruby HTML

The output uses the standard ruby elements: the kanji, then a small reading inside rt, with rp brackets for old browsers that cannot draw ruby. Paste it into the HTML of a page and add a little CSS if you want larger readings: rt { font-size: 0.55em; } is a common starting point. Give the line more height (a line-height of 2 or more), or the readings will touch the line above. Not every editor shows ruby, and some email programs strip it; if yours does, use the bracket form.

Kanji(reading)

This is plain text, such as 今日(きょう)は東京(とうきょう)へ行(い)きます. It pastes anywhere: chat, a note, a spreadsheet cell. For a vocabulary list, paste several lines into a spreadsheet and use find and replace on the brackets to split word and reading into two columns, which many flashcard programs import.

Hiragana only

Every kanji word is replaced by its reading, and everything else stays as it is. This suits a text-to-speech engine that mispronounces kanji, or a first-grade reader. Katakana and punctuation are not changed, so the result is still a readable sentence.

How much furigana is right?

Annotating everything is the safe choice for beginners, but it makes the page crowded and trains the eye to skip the kanji. Many teachers add furigana only above kanji that are above the learners' level. If you want that, produce the full version, then delete the readings for the words your readers already know. The bracket form makes this easy to edit in any text editor.

Mixing furigana with other study tools

Furigana is a reading aid, not a dictionary. Once a text has readings, the next step for a learner is usually a list of unknown words with meanings, a recording to listen to, or a translation to compare. The bracket output copies cleanly into notes and flashcard apps, and the hiragana-only output gives a text-to-speech voice a chance to say each word the way the dictionary reads it. Keep the original kanji text beside the annotated one, so you can fix a reading in one place and regenerate the other.

Privacy and offline use

The text is analysed in your browser, in a background thread, and never sent to a server. The first use downloads the dictionary, about 18 MB, from this site; the browser keeps it, so the tool also works offline afterwards. That matters when the text is a student's essay, a letter or a contract draft that should not leave the device.

When to use a different tool

For Chinese text use the Chinese to Pinyin converter, which reads the same characters in Mandarin. For Korean, Korean Romanization writes Hangul in Latin letters. Furigana is only for Japanese: kanji in a Chinese or Korean sentence are read differently.