A diff tool offers you a choice that looks minor — line, word, or character mode — and then quietly changes what you see. The same two paragraphs can look barely changed in one mode and heavily changed in another, and neither view is wrong. Each mode answers a different question, and using the wrong one for your document either hides the change you need or drowns you in noise. Understanding the three modes takes five minutes and saves a great deal of confusion afterwards.

Text and Document Comparison offers all three modes, with side-by-side and inline views, and options to ignore whitespace and case. This post runs the same fictional paragraphs through each mode, so you can see exactly what changes between them and choose deliberately next time.

Line mode: the map of the document

Line mode compares text line by line. A line that is identical in both versions shows as unchanged; a line that differs at all shows as changed, however small the difference inside it. This makes line mode the best map of a document: it tells you which paragraphs or lines were touched, added, or removed, without demanding that you read every word.

Consider two fictional versions of a short policy paragraph from example.org. Version one reads: "Staff may work from home on Fridays, subject to manager approval, and must be reachable by phone during working hours." Version two reads: "Staff may work from home on Fridays, subject to manager approval, and must be reachable by phone or email during working hours."

In line mode, this whole line shows as changed, because one line contains a difference. That is both the strength and the limit of the mode: it locates the changed line instantly, but it does not show you that only two words — "or email" — were added. For a long document, line mode is the right first pass, because it narrows a hundred lines to the handful that matter. For a detailed read, it is too coarse on its own.

Line mode also handles added and removed passages cleanly. A new paragraph appears as added lines, a deleted passage as removed lines, and the shape of the revision is visible at a glance. When you first open a comparison, line mode answers the question: where did anything change at all?

Word mode: the reading mode

Word mode compares word by word, and it is the mode most people should spend most of their time in. Returning to the policy paragraph, word mode highlights precisely the added words "or email" and leaves the rest of the line unmarked. The change is now readable in context: you see the old sentence with the new words inserted, and the meaning of the edit is immediately clear.

Word mode is the right choice for prose — articles, contracts, policies, essays — because prose changes at the level of words. A rewritten sentence, a swapped term, a softened verb: all of these are word-level events, and word mode shows them at their natural size. It also keeps the noise down: a single changed word does not paint the whole paragraph as changed, so a lightly edited document reads as lightly edited, which is the truth.

The mode has one blind spot, and it matters for figures. A number that changes from 4800 to 4300 is, to word mode, one changed word. The highlight covers the whole number, and the size of the change — one digit, or a completely different figure — is not obvious from the highlight alone. That is where the third mode comes in.

Character mode: the forensic mode

Character mode compares character by character, and it is the most precise and the noisiest of the three. In the policy example, character mode highlights the added characters "or email" exactly as word mode does, but its real value appears with numbers and names. Compare "The fee is $4,800 per year" with "The fee is $4,300 per year": word mode flags "$4,800" versus "$4,300" as a changed word, while character mode highlights just the single digit that changed, the 8 becoming a 3.

That precision is invaluable for contracts, financial documents, and any text where a single digit carries real consequences. It is also exhausting across a whole document, because a rewritten sentence appears as a storm of highlighted characters rather than a readable edit. Character mode is a magnifying glass: superb for examining one passage, terrible for surveying a landscape. Use it last, on the passages that contain figures, names, dates and codes — the places where one character is the whole story.

For a broader comparison guide, see comparing documents.

Worked example: the same paragraphs, three views

Here is the full fictional example in one place, so the differences between modes are concrete. Version one, two sentences: "All orders ship within three working days. Delivery is charged at $12 per parcel." Version two: "All orders ship within two working days. Delivery is charged at $12 per parcel, except for orders over $50, which ship at no charge."

Line mode marks the first line as changed and the second as changed, and tells you both sentences were touched. Word mode shows the real story: "three" became "two," and the second sentence gained the clause "except for orders over $50, which ship at no charge." Character mode shows the same changes, plus the individual letters inside "three" and "two" that differ — precise, but harder to read as sentences.

Notice how each mode's answer to "what changed?" gets more detailed and less readable. Line mode: two lines changed. Word mode: one word swapped, one clause added. Character mode: these letters differ. All three are true. The right question is not which mode is correct, but which level of detail your task needs right now — and the answer usually changes as you move from surveying a document to reading its edits to verifying its figures.

Honest limitations

No diff mode understands meaning. A sentence rewritten to say the same thing in different words will show as heavily changed in every mode, while a sentence with one swapped word that reverses its meaning — "must" becoming "must not" — shows as a tiny change. Modes measure textual difference, not importance, so the reader must still judge which changes matter. Diff tools also struggle with reordered text: a paragraph moved to another part of the document may appear as a deletion and an addition rather than a move, depending on the tool. Finally, formatting differences between versions can create noise in any mode, which is why ignoring whitespace and case is worth trying when a comparison looks noisier than the real edits justify.

FAQs

Which diff mode should I start with?

Line mode. It maps the document and shows you which passages changed at all, so you can focus the detailed reading where it counts instead of reading everything.

When is word mode better than line mode?

Whenever you are reading prose edits. Word mode shows the changed words in context, which is how you judge whether an edit improves a sentence or alters its meaning.

Is character mode ever worth the noise?

Yes, for passages with figures, dates, names and codes. A single changed digit can matter enormously, and character mode is the only view that isolates it precisely.

What do side-by-side and inline views change?

Only the layout, not the comparison itself. Side-by-side puts the versions next to each other, which suits wide screens; inline merges the changes into one flow, which suits narrow screens and printing. The modes work the same in either view.

If you need to compare files rather than pasted text, Compare PDF diffs two PDFs, and JSON Studio handles structured data comparisons.

human review pending client designation