Guide

Your documents live on the Documents page of the dashboard. Click New Document to start one, and use New Folder to keep them organised. Hover over a document or folder to share, rename or delete it.

Open a document from the Documents page to edit it.

The buttons above the toolbar:

• Full screen and the text style menu (Pinyin, Grouped, Hanzi).
• Results — the answers to the document's exercises (shown once the document has one).
• Start lesson — run the document live with a class (teachers only).
• View — open the document the way readers see it.

Just type. Shortly after you stop typing, hao2learn splits your Chinese into words and looks each one up in the dictionary. Every word becomes tappable: anyone reading the document sees its pinyin and meaning in one tap. English and Chinese can be mixed freely.

Use the text style menu to choose how Chinese is shown while you edit: with pinyin above every word, grouped into words, or as plain hanzi. Readers choose their own style.

The automatic word split is usually right, but not always. Click any Chinese word to open its word card:

• Change meaning — pick another dictionary entry for the same characters (e.g. the right reading of 行 or 了), or write your own pinyin and meaning. Type pinyin with tone numbers (luo1ji2) and it turns into luójí.
• Split / merge — click a ✂ between two characters to cut the word, or one of the arrow buttons to join it with the word before or after.
• Open dictionary — the full dictionary entry with examples.

Words you fixed by hand stay as they are, even when you edit the text around them.

Click (left speaker) or (right speaker) to turn the current line into a chat bubble. Type the speaker's name above the bubble.

• Enter at the end of a bubble starts the reply on the other side, with that side's speaker filled in.
• Enter in an empty bubble ends the dialogue; Shift + Enter adds a line break inside a bubble.
• The ⇄ button next to the name moves a bubble to the other side.

Click to insert a table — handy for vocabulary lists. While the cursor is in a table, a second toolbar row appears to add or delete rows and columns, switch the header row on or off, or delete the whole table.

Click to add one or more pictures, or simply paste or drag an image into the document. Click to add an audio file, which can be played right in the document.

Click a picture to select it: choose its size (S, M, L) or delete it. Pictures, audio and exercises can be dragged to another place in the document.

Click Translate to translate between English and Chinese without leaving the editor. Type (or select text in the document first, and it is filled in for you), choose Natural or Easy Chinese, and pick one of the suggested versions. Insert below adds it to your document, already split into words.

Click Interactive to add an exercise where the cursor is. Readers answer on their own device, and the results come in as they answer.

• Multiple choice — one question, a few options, one right answer.
• Vocabulary test — up to ten flip cards; updates each student's word progress.
• Fill the gaps — a text with blanks, filled from a word bank or a few choices.
• Re-arrange — put scrambled words back into the right order.
• Guided writing — write sentences with a given grammar pattern; AI corrects them.
• Free writing — write a short text on a task; AI corrects it, or it is just collected for you.

Fill in the exercise and set how many attempts readers get and when they see the result (straight away, when you reveal it, or never), then click Save.

In the document the exercise looks exactly as readers see it, so you can try it out. Use Edit to change it, ↻ to reset your test answer, or the bin to delete it.

Click Start lesson to run the document with your class. Students scan the QR code or type the code at hao2learn.com/l — no account needed.

• Presentation mode is made for the projector: move the class through the document section by section and release the answers when you are ready.
• While the lesson runs, the top bar shows the code and how many students have joined. Click the code to show it again.
• When you stop the lesson, its results open automatically (if anyone answered).

Results shows every answer per exercise — from a live lesson or from anyone who opened the share link — and you can switch between past lessons.