Text Comparison Guide: How Diff Tools Work
What Is a Diff?
A diff is the result of comparing two versions of a text and highlighting what changed. The term comes from "difference" and has been a cornerstone of software development since the 1970s, when Douglas McIlroy at Bell Labs created the original diff utility for Unix.
At its core, a diff tool answers one question: what lines were added, removed, or changed between two texts?
How Diff Tools Identify Changes
Diff tools break text into lines and search for the longest sequences that remain unchanged. These matching lines act as anchors. Everything between anchors is marked as deleted (from the old text) or added (in the new text).
The process follows three steps:
- Tokenize — Split both texts into comparable units (usually lines)
- Match — Find the longest common subsequence between the two sets
- Mark — Label unmatched lines as additions or deletions
Most tools also detect when a line was modified rather than deleted and re-added — this is called a change edit and produces cleaner output.
Diff Output Formats
Unified Diff
Unified diff is the most common format. It shows changes in a single stream with a few lines of context around each change. Git uses this format by default.
@@ -2,5 +2,6 @@
function greet(name) {
- console.log("Hello, " + name);
+ const message = `Hello, ${name}`;
+ console.log(message);
}
Lines starting with - are deletions from the original. Lines starting with + are additions in the new version. The @@ header shows line numbers: -2,5 means "starting at line 2, 5 lines from the original" and +2,6 means "starting at line 2, 6 lines in the new version."
When to use it: Code reviews, patch files, and any situation where you need a compact, copy-paste-friendly representation.
Side-by-Side Comparison
Side-by-side diff places the original and modified texts next to each other. Matching lines stay aligned, and changed lines are highlighted on both sides.
| Original | Modified |
|---|---|
console.log("Hello"); | console.log("Hi there"); |
return result; | return result; |
When to use it: Document revision, legal text comparison, and any scenario where seeing both versions simultaneously reduces cognitive load.
Inline Diff
Inline diff overlays additions and deletions within a single text view. Deleted text appears struck through, and added text appears with a highlight — often in green.
When to use it: Quick reviews of short texts, collaborative writing, and interfaces where horizontal space is limited (like mobile screens).
Common Use Cases
Document Revision
Writers and editors use diff tools to track changes between drafts. Legal teams compare contract versions to spot clauses that changed between negotiations. Unlike word processor track changes, a diff tool works on any plain text.
Code Review
Every pull request on GitHub and GitLab is built around diff views. Reviewers scan additions and deletions to catch bugs, security issues, and style inconsistencies without reading the entire file from scratch.
Configuration Audits
System administrators compare configuration files before and after changes. A diff of nginx.conf or sshd_config instantly reveals what was modified, helping prevent outages caused by accidental edits.
Data Validation
When exporting data from two systems, a diff of the output files confirms whether the results match. Even a one-character difference — a trailing space or encoding mismatch — shows up immediately.
Choosing the Right Format
| Format | Best For | Drawback |
|---|---|---|
| Unified | Patches, code review | Hard to read for long changes |
| Side-by-side | Document comparison | Needs wide screen |
| Inline | Quick scans, mobile | Can look cluttered |
Most modern diff tools let you switch between formats depending on the task at hand.
Tips for Better Comparisons
- Normalize whitespace before comparing if you only care about content, not formatting
- Trim trailing whitespace to avoid false positives from editor artifacts
- Use context lines (typically 3) so you can orient yourself without reading the entire file
- Ignore case when comparing user-facing text where capitalization may vary
- Compare smaller chunks — splitting a large change into logical sections makes review faster
Related Guides
Try It Yourself
Use our free Diff Checker to compare two texts side by side. Paste your original and modified text, choose your preferred view, and see every difference highlighted instantly — no installation required.