What is zhuyin fuhao?

Zhuyin fuhao, commonly called bopomofo after its first four symbols, is the phonetic system taught in Taiwan. It writes each syllable with consonant and vowel symbols plus a tone mark, and is the standard way learners annotate Traditional Chinese.

Does it cover every character?

It uses a built-in lookup table of common characters. Many Chinese characters have multiple readings depending on context, so rare or polyphonic characters may be left unannotated or show the most frequent reading. Always proofread important text.

What is HTML ruby markup?

Ruby is the standard HTML element for placing small annotation text above base text. The tool wraps each character in a ruby element with an rt for the reading, which browsers render as the phonetic guide sitting above the character.

Why might a reading be wrong?

Chinese has polyphonic characters whose pronunciation changes with the word, such as 行 (xíng vs háng). A character-by-character lookup cannot resolve this from context, so it shows the most common reading. Manual correction may be needed.

No. Annotation is performed locally in your browser using a built-in table. Nothing you paste is sent to a server.

Traditional Chinese Pinyin Annotator

Email me this result

Get this tool's output sent to your inbox, plus one useful tool a week. No spam, unsubscribe any time.

Annotate Traditional Chinese with phonetics

Learners of Traditional Chinese often need a pronunciation guide above each character. This annotator wraps your text in standard HTML ruby markup, placing either zhuyin fuhao (bopomofo, the Taiwan standard) or Hanyu Pinyin above each Han character so the preview reads like a textbook.

How it works

Each character is looked up in a built-in table that maps common Traditional Chinese characters to their reading:

為每個漢字  →  <ruby>為<rt>ㄨㄟˋ</rt></ruby> …

The tool walks your text one character at a time and looks up its reading in pinyin or converts that pinyin to zhuyin with a tone mark.
Recognised characters are wrapped in a ruby element with an rt reading; punctuation and unknown characters are passed through unchanged.
The result is shown as a live preview and as copyable HTML markup.

Notes and limitations

Many Chinese characters are polyphonic — 行 is xíng in 行走 but háng in 銀行 — and a character-by-character lookup cannot tell which reading the context needs. The annotator shows the most common reading, so proofread anything important. The built-in table covers frequent characters; rare ones are left unannotated. All processing happens in your browser.