A PRACTICAL MAC GUIDE

How to type pinyin tone marks on a Mac

To write nǐhǎo instead of ni3hao3, you can use your Mac’s built-in ABC – Extended keyboard, a numbered-pinyin converter, or a pinyin tone keyboard such as ToneTap. The best choice depends on how often you write pinyin.

By Jude St John, creator of ToneTap · Updated November 15, 2026

In this guideChoose a way to type pinyinUse ABC – Extended for occasional tone marksType tone numbers with ToneTapWhere does the tone mark go?Type ü, lǜ, and nǚFix common problems

Pinyin text and Chinese characters use different input flows

If you need Latin letters with tones, such as Hànyǔ Pīnyīn, look for pinyin tone-mark input. A Chinese character input method usually takes a spelling such as nihao and offers characters such as 你好. ToneTap writes the Latin pinyin text; it does not provide Chinese character candidates or translate your words.

Three ways to write accented pinyin on Mac
MethodUseful forSetup
ABC – ExtendedOccasional accented lettersBuilt into macOS; add an input source
Free browser converterExisting numbered pinyin to copy and pasteNo Mac app installation
ToneTap keyboardTyping numbered syllables directly in compatible Mac appsPaid Apple silicon app; install and restart

Option 1: add ABC – Extended

Apple includes a Latin keyboard layout that can enter pinyin tone marks. This is a useful free option if you only need an accented letter now and then.

  1. Open System Settings → Keyboard → Text Input → Edit.
  2. Click +, search for ABC – Extended, and add it. On older macOS versions, use System Preferences → Keyboard → Input Sources.
  3. Select ABC – Extended in the menu bar’s input menu.
  4. Use Keyboard Viewer to see the layout and its accent keys. Hold Option to reveal the available dead keys; an accent dead key is entered before the letter it modifies.

The exact keys you see depend on the active layout. Apple documents accent entry and ABC – Extended for pinyin. You choose which letter receives the mark, so learn the placement rules below.

Option 2: type a syllable and its tone number

ToneTap takes a pending syllable followed by a number from 1 to 5 and places the tone mark for you. For example, ni3hao3 becomes nǐhǎo, while Han4yu3 Pin1yin1 becomes Hànyǔ Pīnyīn. Use 0 or 5 for a neutral syllable, with no written tone mark.

  1. Check that your Mac has an Apple silicon M-series chip and runs macOS 12 or later.
  2. Download ToneTap through its product page, open the included graphical installer, and click Install ToneTap.
  3. Save your work and restart, or sign out and back in.
  4. Add ToneTap under English in Keyboard → Text Input → Edit → +. Select it from the menu bar and type ma1 ma2 ma3 ma4 ma5.
About macOS download approval: ToneTap is an early release and is not notarized by Apple. macOS may require an approval in Privacy & Security. Read the installation notes before purchasing. Fresh-Mac installation and compatibility across apps are still being tested.

Which vowel gets the pinyin tone mark?

For the ordinary vowel spellings covered here, use these placement rules:

  1. If the syllable contains a, mark the a: hao3 → hǎo.
  2. Otherwise, if it contains e, mark the e: xie4 → xiè.
  3. For ou, mark the o: dou4 → dòu.
  4. Otherwise, mark the final vowel: liu2 → liú and shui3 → shuǐ.

ToneTap chooses the position for a valid syllable. It checks spelling against its syllable inventory, but does not decide whether a particular word uses the tone you entered. You still supply the intended tone number.

How to type ü and add a tone above it

In ToneTap, type v or u: as a shortcut for ü inside a supported syllable. nv3 and nu:3 both produce nǚ. lv4 produces lǜ; lu4 produces lù. These are distinct spellings.

You can also paste numbered syllables into the free pinyin tone converter to copy the accented result. Already-accented text is left alone.

Why isn’t a syllable converting?

Check the input source and tone number

Make sure ToneTap is selected, then type a complete syllable followed by its number. xio can still become xiong, so it remains a possible prefix; xio3 is incomplete and stays literal. xiong2 becomes xióng.

Correct a typo before entering the number

Backspace edits the current composition. Typing xiof, deleting f, and then typing ng2 produces xióng. Typing lia, deleting a, then typing u4 produces liù. Once a tone number or delimiter commits the text, use the app’s ordinary text editing.

Switch keyboards for English

Some English strings are also valid pinyin syllables, such as can or fan. A tone keyboard cannot infer your intended language from those letters. Switch back to ABC or U.S. for English, code, passwords, and literal number strings.

Allow for early-release limits

ToneTap does not include every rare or dialectal spelling or erhua suffix. It writes pinyin only and does not teach pronunciation. If a valid spelling fails, send feedback with the spelling and your macOS version, without private text.

Try the free pinyin converter ↗