Adding Pinyin means writing pronunciation next to or instead of a line of characters. Teachers use it for beginners. Editors use it to check a name. Learners use it when a character is new. Parents use it on a worksheet so a child can read a story they cannot yet write from memory.
ChineseDocConverter can generate Pinyin from pasted text or from an uploaded file. That is a pronunciation layer. It does not convert 简体 to 繁體. Do character conversion first if you need both, because the Pinyin of 国 and 國 is the same syllable. The character standard is a separate choice.
What "adding Pinyin" can look like
There is no single layout. Common patterns include:
- Ruby / interlinear: Pinyin above each character or each word. Textbooks like this. Office files imitate it with extra lines or small fonts.
- Parallel line: a line of characters, then a line of Pinyin under it.
- Trailing annotation: 中国 (Zhōngguó) in a glossary.
- Replacement: Pinyin only, for a first-week handout. Native readers find this tiring past a paragraph.
Decide the layout before you generate, so you do not paste a wall of syllables into a design that wanted ruby.
Word spacing is a house-style choice. Some teachers space every syllable (zhōng guó). Some group by word (zhōngguó). Pick one for the document.
Text and files
- Paste into Chinese to Pinyin for a paragraph or a glossary.
- Upload a document on the same Pinyin page when the Chinese already lives in Word, Excel, PowerPoint, PDF or TXT.
- If you already type
ni3 hao3and only need marks, use the Pinyin Writer. That tool does not read characters.
PDFs only work when the Chinese is real text. A scan of a workbook page needs OCR first, the same limit described in the PDF guide.
Limits you should expect
Polyphones (多音字). 行 can be xíng or háng. 还 can be hái or huán. 了 can be le or liǎo. A library guesses from context and can be wrong. Check names, poem lines, and textbook example sentences that were written to illustrate an uncommon reading.
Proper names. A given name may use a rare reading. Family tradition beats the dictionary. If you are annotating a name list, have a person who knows the people.
Tone sandhi. Generated Pinyin often prints citation tones. Spoken 你好 may not match the marks one-to-one. See the four tones.
Variant spellings. lü versus lv, numbered tones versus marks, spaces versus camel-case. For mark shapes, see tone marks vs tone numbers.
Mixed languages. English words should stay English. If a file is full of product codes, skim the output for syllables that should never have been romanized.
A sensible sequence
- Finish the Chinese text, including any Simplified/Traditional conversion.
- Generate Pinyin from that final character layer.
- Search for known polyphones in your subject (numbers, names, 行, 还, 觉).
- Apply your spacing and capitalization style.
- Only then paste into the designed worksheet or slides.
If you generate Pinyin first and convert characters later, you have not hurt the Pinyin, but you have done the work in an order that confuses collaborators. Characters first is easier to explain.
Frequently asked questions
Can I add Pinyin only to hard characters? Yes, by selecting those words and running them through the text tool. Mixed annotation is normal in intermediate teaching.
Will the tool put marks on the correct vowel? It follows standard Pinyin placement. If a syllable looks wrong, check whether the reading itself is the wrong polyphone.
Is this the same as a Chinese IME? No. An IME turns Pinyin into characters. This tool turns characters into Pinyin.
Can I get Zhuyin instead? Not from these tools. They output Hanyu Pinyin.
Does adding Pinyin change my document's language for screen readers? It can, if you replace the characters. Prefer annotation if the file must remain readable as Chinese.