Why do xiangqi books still rely on diagrams alongside written notation?
These answers restate the rules implemented by our open-source engine, which follows the WXF laws and is regression-tested against the official 110-diagram repetition casebook. Where an answer refers to a specific position, that position lives on the linked reference page, where the build verifies it against the engine before publishing.
Direct answer
Because notation and diagrams do different jobs. Move notation records a sequence of actions, one at a time; a diagram shows the entire board at a glance, with nothing to reconstruct. Xiangqi's larger 90-point board and less familiar piece shapes make mentally tracking a position from a long move list considerably harder than doing the same in chess, so diagrams earn their space more often.
Where diagrams do work notation cannot
At a key turning point in a game, a diagram lets a reader verify the position instantly rather than replaying every move from the start to check it. This is especially valuable in endgame study, where a small error accumulated over many moves can leave a reader working from a subtly wrong picture without realising it.
Why notation is still necessary alongside them
A diagram alone cannot show how a position was reached or explain the reasoning behind it. The two are complementary: notation for the process and the record, diagrams for anchoring the reader's mental picture at the moments that matter most.
Related questions
Does this site use diagrams the same way?
Yes, every position discussed is backed by a verified board; see what FEN is in xiangqi for how positions are stored behind those diagrams.
Are diagrams more common in xiangqi books than chess books?
Broadly similar in practice, though the case for including one at any given point is often somewhat stronger given the larger board.
.