Tutorials

What this hub is

Until recently this site kept its help content in two separate places. One was a set of step-by-step how-to tutorials for finishing a job. The other was a set of reference pages explaining how pinyin actually works — charts, tone rules, and the characters people read wrongly. The division made sense to us as authors and no sense at all to anyone else. If you arrive wanting to put pinyin above a page of Chinese, you do not usually care whether your question counts as "how-to" or as "fundamentals". So the two areas have been merged into this one page, and it is organised by what you want to do rather than by how we happen to file it internally.

To be clear about what sits behind everything here: this is a browser-based pinyin annotation toolkit. You paste Chinese text, it places pinyin above each character, and you export the result to Word or PDF so it can be printed. There is nothing to install and no account to create. It is written for three groups in particular — adults studying Chinese on their own, parents raising bilingual children, and teachers of Chinese as a foreign or heritage language. No prior knowledge of romanisation is assumed, and you never need to read the whole page. Find the section that matches your situation and start there.

Quick start: add pinyin in three steps

If you have never used the tool, the mechanical part takes under a minute. All three steps happen on one screen at the annotator.

1. Paste your text. Copy Chinese from wherever it lives — a Word file, a PDF, a web page, a passage you retyped by hand — and drop it into the input box. Formatting is stripped away, which is what you want: the tool needs characters, not your margins. Paragraph breaks survive, so a short story keeps its shape on the page. One common mistake is pasting a block that mixes Chinese with an English translation on alternating lines; the tool will dutifully annotate the Latin words too, which looks cluttered. Keep the two languages in separate blocks and combine them afterwards if you need to.
2. Click Convert. Every character receives its pinyin. The conversion is context-aware: before deciding how to pronounce a character with more than one reading, the tool looks at the characters around it. So 行 becomes háng inside 银行 (bank) and xíng inside 行走 (to walk). This is the part that pays for itself. Checking a few hundred characters against a paper dictionary is an evening's work; here it is a few seconds. Expect to double-check more by hand when you are working with something unusual — classical poetry, dialect-flavoured dialogue, or a wall of proper nouns — because context heuristics are at their best on ordinary modern prose.
3. Adjust the pinyin and export. Set the pinyin colour and size to suit your reader, then send the result out. Choose Word when you still intend to edit the layout, add pictures, or paste the annotated text into a worksheet template of your own. Choose PDF when you are going straight to the printer and want pagination to stay exactly as you arranged it. Print it, hand it to a student, or save it as a reading sheet for later.

Characters with more than one pronunciation are the place where any automatic system, ours included, will now and then choose wrongly. When the tool is less than confident it marks the character with a dotted underline. Click that character and a short list of possible readings appears; choose the one you want and the annotation updates in place. Treat the dotted underline as a question rather than an error — it is the tool telling you this one deserves a human glance.

Automatic detection cannot be perfect, because the information needed to settle a reading often sits outside the sentence. Place names are a good example: the 重 in 重庆 (Chóngqìng) is read chóng, while the same character in 重要 (zhòngyào, "important") is zhòng, and nothing in the surrounding grammar tells you which. Surnames behave the same way — 单 is shàn as a family name but dān in ordinary words. Idioms and set phrases often preserve literary readings that differ from everyday speech, and a handful of characters simply switch reading by part of speech: 长 is cháng ("long") as an adjective and zhǎng ("to grow, elder") as a verb. 乐 is yuè in 音乐 ("music") and lè in 快乐 ("happy"). 得 is dé ("to obtain"), děi ("must"), and a neutral de when it links a verb to a result. No rule engine resolves all of these from context alone, which is exactly why the manual override exists and why a quick read-through before printing is worth the two minutes it costs.

The tool also handles both simplified and traditional characters, and can convert between them before annotating. That matters if you teach in Taiwan or Hong Kong, or work with families whose books and school materials are traditional. Conversion is not perfectly one-to-one — several simplified characters map to more than one traditional form depending on meaning, and a few merges lose information — so treat automatic conversion as a fast first pass and read it over before you rely on it. The details are covered in pinyin for traditional Chinese text.

Pinyin fundamentals

The five reference pages below are ordered on purpose, and reading them in sequence will save you confusion later. Pinyin is small enough to look learnable at a glance — a few dozen initials and finals, four tones, done — and that is precisely the trap. Learned piecemeal, the rules turn into a pile of exceptions, because each new sound seems to contradict the last one you half-remembered. Worked through in order — the chart first, then the tone rules, then the specific sounds that trip people up — most of those apparent contradictions resolve, and the exceptions become predictable.

• Pinyin chart: initials, finals and whole syllables — the full inventory, grouped by how each sound is actually produced rather than presented as a list to memorise.
• Tone change rules explained — the four tones and the neutral tone, third-tone sandhi, and the shifting tones of 一 and 不, with the patterns spelled out.
• Commonly mispronounced sounds — z/zh, c/ch, s/sh, n/ng, f/h and n/l compared side by side, so you can hear what your mouth is doing wrong.
• Common polyphonic characters — the characters learners most often read incorrectly, each with the words that reveal which reading applies.
• 500 essential Chinese characters with pinyin — the highest-frequency characters with their pinyin, flagging the readings that catch people out.

Task-based how-to guides

Most people who come to this site do not want a systematic pinyin course. They want to finish the thing in front of them: get pinyin onto a passage so a learner can read it, produce a worksheet that a beginner can work through alone, or assemble a picture book for a child. These tasks share two requirements — the output has to be a printable, pinyin-annotated document, and making it should not eat an entire evening. The guides below are arranged by task rather than by grammar point, and every step in them can be carried out with the online tool. Nothing needs to be installed.

• Graded Chinese reading practice — turn any passage into a pinyin reading sheet sized for a single session, and judge whether the level is right.
• Adding pinyin to worksheets and tests — annotate exercises so beginner readers can complete them without an adult reading every prompt aloud.
• How to make a pinyin picture book — from preparing the text to choosing a layout, ending with a book you can print and bind.
• Picture Book Studio: the full guide — doing annotation, illustrations and layout in one browser tool, with the details on layouts, image controls, page sizes, printing and drafts.
• Pinyin for traditional Chinese text — convert between simplified and traditional forms, then annotate, for readers in Taiwan, Hong Kong and overseas communities.
• Printing and binding — page setup, double-sided printing, saddle stitching and paper choice, done properly the first time.

These guides and the fundamentals pages are designed to be used together rather than chosen between. The how-to pages tell you what to click; the reference pages tell you why a character is read the way it is, which is what lets you catch a bad conversion instead of trusting it blindly. A teacher who has skimmed the tone rules spots a wrong sandhi at a glance; someone who has never met them will not know it is wrong. Start with whichever page matches your immediate need, and dip into the other set when a specific character or sound raises a question.

For parents and bilingual families

For a child learning Chinese, pinyin is the bridge between being read to and reading alone. It is a strange bridge, though, because of an awkward stage that almost every bilingual family hits. The books the child can decode are too babyish to want; the books the child wants are still out of reach. Pinyin-annotated readers fill precisely that gap. When an unfamiliar character appears, a glance upwards is enough to keep going, so the story is never interrupted and the child stays inside the plot. That sustained reading time is what builds fluency, far more than any drill.

But how you use the pinyin changes the outcome as much as whether you use it. Annotate every character and a child may simply read the romanisation and stop looking at the characters. Annotate nothing and frustration wins. The useful middle ground — annotating new or hard characters only, letting the child attempt the rest first — is a judgement call, and it shifts with age and confidence. The size and colour of the pinyin matter too: large, high-contrast pinyin pulls the eye away from the characters, while small, low-contrast pinyin at the tip of the tongue keeps attention where you want it. None of these decisions is one-time; revisit them as the child grows.

• Reading Chinese with kids — age-by-age approaches, and the mistakes parents most often make when they start annotating.
• Making your first bilingual book — use your own story and family photographs to make a book no shop could sell you.
• A guide to graded reading — how to judge whether a text is pitched at the right level before you commit to it.

For teachers

In an early-grades Chinese class, annotation is a recurring and quietly time-consuming prep job. Word lists need pinyin. Reading passages need pinyin. Exercises need pinyin. Flash cards need pinyin. Doing this by hand is slow, and it is error-prone in a way that matters, because a wrong reading printed on a worksheet does not stay wrong on the page — the whole class memorises it. Polyphonic characters are the worst offenders: the ones you are least sure about are the ones students will meet most often, and 行, 长, 乐 and 着 will each cost you a decision every time they appear. Handing the repetitive lookup to a tool returns the hours to the work that genuinely needs a teacher's judgement: designing the lesson, working out where the class is actually struggling, and giving individual support to the students who need it.

• Chinese worksheet templates — annotated character lists, tracing grids, flash cards and practice sheets you can adapt in minutes.
• Teaching pinyin in the classroom — concrete uses of annotation in literacy lessons, read-alouds and revision sessions.

Picture Book Studio

Building a picture book used to mean assembling it by hand, page by page, in a layout program. Picture Book Studio is a new tool on this site that does the whole job in the browser. You write a story of your own or paste a lesson text; the text is annotated automatically; you upload your own illustrations; you pick a layout for each spread — text on its own page, text overlaid on the illustration, or image and text split down the page — and the tool exports a real, multi-page, print-ready PDF. The result is a book, not a screenshot: pages in order, sized correctly, ready to send to a printer or a copy shop.

It exists because the people who need pinyin readers most are usually the people least able to buy them. A parent can make a personal book starring their own child, with their own photographs and a story set in their own kitchen. A bilingual family who cannot find Chinese readers at the right level can build one around a topic their child already loves. A teacher can turn a single lesson into an illustrated read-aloud that the whole class can follow. None of it requires design skill, and nothing is uploaded: your text and your pictures stay in the browser, and no account is needed.

The full guide to Picture Book Studio explains each feature in detail — which layout suits which kind of text, how to reposition and zoom an illustration, why overlaid text is limited to nine fixed positions, how to choose a page size, how printing and binding work, where your draft is stored, and the questions people ask most often. If you would rather understand the overall process first, start with how to make a pinyin picture book, which covers text preparation, layout and printing in the order you will actually do them.

How the content connects to the tools

It is easier to see how the pieces fit if you follow one realistic job from start to finish. Suppose you are preparing a reading handout for a class of eight-year-olds who are partway through a graded reader.

You begin with graded Chinese reading practice to pick a passage of the right length and difficulty, and to see how a single session's worth of text should be laid out. While preparing it you notice a character you are not sure about — say a 乐 that you would read yuè but the sentence might want as lè. Instead of guessing, you check common polyphonic characters and settle it. You then paste the passage into the annotator, click Convert, and read the output with an eye for the dotted underlines, fixing any reading the tool flagged. Finally you set the pinyin size large enough for young eyes, export a PDF, and print — and if you want it to look like a real booklet rather than loose pages, printing and binding tells you how to fold and staple it. Every page mentioned in that walkthrough is free, needs no sign-up, and depends on the same tool.

That last point is worth repeating because it is unusual. Nothing here is gated behind an account, a trial, or a subscription, and the text you paste never leaves your browser — the annotation runs locally, so a passage from an unpublished manuscript or a private lesson stays private. The reference pages and guides exist to make the tool useful, not to sell you anything.

Corrections and feedback

Pinyin has more conventions than it has rules. Different textbooks, regions and publishers disagree about details — how strictly to mark tone sandhi, when to write the neutral tone, which reading to prefer for a character that admits two. Where that happens, the pages here follow common usage rather than pretending to a single absolute standard, and we would rather be corrected than quietly wrong. If a reading, an example, or a wording looks off to you, or if there is a topic you expected to find and did not, write to connorlin072@gmail.com. Tell us which page and, if you can, what you would expect instead; specific reports are far easier to act on than general impressions. Every message is read, and the page is updated whenever the correction holds up. Suggestions for new tutorials are just as welcome as corrections — the order of these sections is not fixed, and gaps tend to be filled in the order readers point them out.