> For AI agents: the complete documentation index is available at https://docs.flashnerd.com/llms.txt, the full documentation bundle is available at https://docs.flashnerd.com/llms-full.txt.

# Chinese

Use a **Chinese** field to display Chinese text with optional pinyin annotations. Annotation visibility lets you practice reading before checking pronunciation.

## Set up a Chinese field

1. Add a Chinese field to the template and choose its side.
2. Open the gear button and choose **Chinese Type**: **Traditional** or **Simplified**.
3. Turn on **Show Pinyin** if you want pronunciation annotations.
4. Choose an **Annotation Setting**, then save the template.
5. Enter Chinese text in a card, such as `你好`, and check **Full Preview** before saving.

Chinese Type selects the generated pronunciation profile: Traditional uses the Taiwan profile, and Simplified uses the Mainland profile. It does not translate your study content or rewrite the characters you entered.

## Choose when pinyin appears

| Annotation setting | Behavior                          |
| ------------------ | --------------------------------- |
| **Hint**           | Long-press to show the annotation |
| **Always**         | Keep annotations visible          |
| **Back only**      | Show annotations on the back face |
| **Off**            | Hide annotations                  |

The **Show Pinyin** switch also needs to be enabled for pinyin to appear. For a word shown on both faces, Back only lets you try reading the front first.

## Correct a reading

1. Enter the card's text before opening its field settings.
2. Under **Pinyin Override**, locate the character/token whose reading needs correction.
3. Enter the intended pinyin in its input. The generated reading appears as a placeholder.
4. Return to the card editor, preview, and save.

Overrides are specific to that card's text. They are not a deck-wide pronunciation dictionary. Check them again after substantially changing the source text.

Pinyin annotations do not themselves create audio. Add a [TTS](https://docs.flashnerd.com/reference/fields/tts.md) field referencing the Chinese field if you also want speech.