Xiangqi notation: how to read and write moves

5 min read · Updated 2026-11-13

Every Xiangqi book, puzzle and game record uses a short code for each move, such as 炮二平五 or C2=5. It looks cryptic at first, but the system is simple and logical: once you know four rules you can follow any game. This guide explains the traditional Chinese notation, the English WXF version, the Vietnamese version and the ICCS coordinates used by computers.

The four parts of a move

In the traditional system a move has four parts: the piece, the file it stands on, the direction it moves, and a number. "Cannon 2 sideways to 5" means the cannon standing on file 2 moves sideways to file 5. That is all.

There are only three directions: forward (进 in Chinese, + in English), backward (退, -) and sideways (平, =). Forward always means towards the opponent, whichever colour you play.

Counting files from your own right

The board has nine files (vertical lines). Each player counts them from their own right hand side, 1 to 9. So Red's file 1 is Black's file 9, and the central file is file 5 for both players.

In Chinese, Red's files are written with Chinese numerals 一 to 九 and Black's with Arabic numerals 1 to 9. This way you can tell at a glance whose move it is: 炮二平五 is a Red move, 马8进7 is a Black move.

What the number means

For pieces that move in straight lines (chariot, cannon, soldier and general), the number after forward or backward is how many points the piece moves. "Chariot 1 back 1" (R1-1) means the chariot on file 1 retreats one point. After sideways, the number is always the file the piece arrives on.

Pieces that move diagonally (horse, elephant and advisor) always change file, so for them the number is the destination file. "Horse 8 forward 7" (H8+7) means the horse on file 8 jumps forward and lands on file 7. "Elephant 3 forward 5" means the elephant on file 3 moves up to the central file. You never need to count ranks for these pieces.

Two identical pieces on one file

Sometimes both chariots or both cannons stand on the same file, so the file number alone does not say which one moves. Then the notation replaces the file number with "front" or "rear": in Chinese 前 and 后, for example 前炮平四 (front cannon to file 4) or 后马进六 (rear horse forward to file 6). Front means the piece closer to the opponent.

If three or more soldiers share a file, the middle one is called 中. Vietnamese records say "trước" and "sau" in the same way, such as "Pháo trước bình 4".

Vietnamese notation

Vietnamese players use the same logic with Sino Vietnamese words: tấn (forward), thoái (back) and bình (sideways). The pieces are Tướng (general), Sĩ (advisor), Tượng (elephant), Xe (chariot), Pháo (cannon), Mã (horse) and Tốt (soldier). 炮二平五 becomes "Pháo 2 bình 5" and 马8进7 becomes "Mã 8 tấn 7". Both colours use ordinary digits.

In books and on forums you will often see a short form: the first letter of the piece, a dot for forward, a slash for back and a hyphen for sideways. "Pháo 2 bình 5" is written P2-5, "Mã 8 tấn 7" is M8.7.

WXF notation in English

The World Xiangqi Federation (WXF) notation is the usual English form. Each piece has a letter: K (king or general), A (advisor), E (elephant), H (horse), R (rook or chariot), C (cannon) and P (pawn or soldier). Then come the file, a sign (+ forward, - back, = sideways) and the number.

So 炮二平五 is C2=5, 马8进7 is H8+7 and 车一退一 is R1-1. The rules for the number are exactly the same as in Chinese. Some English books use N for the horse and B for the elephant instead, so check the key at the start of the book.

ICCS coordinates for computers

Engines and many websites use ICCS coordinates instead. The files are letters a to i from Red's left to Red's right, and the ranks are numbers 0 to 9 starting from Red's back rank. A move is just the start point followed by the end point, so it does not depend on whose turn it is.

Red's file 1 is file i, and Black's file 1 is file a. Red's cannon on file 2 starts on h2, so 炮二平五 is h2e2. ICCS is less friendly for people but has no ambiguity at all, which is why software prefers it.

A worked example: Central Cannon against Screen Horses

Here are the first four moves of one of the most common openings, written in every system.

Move 1, Red: 炮二平五, Pháo 2 bình 5, C2=5, h2e2. The cannon on Red's file 2 moves to the central file. Move 1, Black: 马8进7, Mã 8 tấn 7, H8+7, h9g7. Black's horse on file 8 jumps forward to file 7 to protect the central soldier.

Move 2, Red: 马二进三, Mã 2 tấn 3, H2+3, h0g2. Move 2, Black: 车9平8, Xe 9 bình 8, R9=8, i9h9. Black's chariot steps one file to the side, onto the file that the horse just opened.

Set up a board in the ChessZing analysis board, play these moves and watch the move list: reading notation becomes natural after a few games.

Practise in the app →

Frequently asked questions

Why does Black count files differently?

Each player counts from their own right, because the notation was made for players sitting at the board. Black sits on the other side, so the numbers run the other way. The central file is 5 for both.

Does "forward 2" for a horse mean it moves two points?

No. For the horse, elephant and advisor the number is the file where the piece lands. Only straight moving pieces use the number as a distance.

Which notation should I learn first?

Learn the system used by the books or videos you follow. The logic is the same in Chinese, Vietnamese and WXF, so once you know one, the others take a few minutes.

Can I practise reading moves on ChessZing?

Yes. Every game on ChessZing has a move list, and in the analysis board you can play through any line yourself and see each move written out.

Related guides

Language: English · Tiếng Việt · 简体中文 · 繁體中文