Overview
Use sed to print transformed text without changing the original file. A substitution rule has the form s/pattern/replacement/. Preview the result before choosing an in-place edit.
Background
The name is short for stream editor: sed edits text as it flows from a file or pipe instead of opening it in an editor. A sed command, written by L. E. McMahon, appeared in Version 7 Unix, according to the FreeBSD and macOS manuals. Today the name covers separate programs: GNU sed, the sed that macOS ships, and the compact sed inside BusyBox. They agree on the substitution and printing examples below and differ on in-place editing, extensions, and regular-expression details.
Examples
Replace the first occurrence of old on each line:
sed 's/old/new/' notes.txt
Replace every occurrence on each line:
sed 's/old/new/g' notes.txt
Print only lines 2 through 4:
sed -n '2,4p' notes.txt
Delete the lines that match a pattern from the output:
sed '/second/d' notes.txt
Print only the lines that match a pattern:
sed -n '/third/p' notes.txt
Skip the first line, for example a header:
sed '1d' notes.txt
Print only the last line:
sed -n '$p' notes.txt
Apply two rules in order:
sed -e 's/old/new/' -e 's/second/2nd/' notes.txt
Use another delimiter when the pattern contains slashes:
echo '/usr/local/bin' | sed 's#/usr/local#/opt#'
Use an extended regular expression to replace runs of digits:
echo 'a1b22' | sed -E 's/[0-9]+/N/g'
Options
-n
Suppress automatic printing. Pair it with a rule such as p to explicitly print selected lines.
-e
Add an editing rule. Repeat -e to apply multiple rules in order.
-E
Use extended regular expressions, so +, ?, |, and () work without backslashes. GNU, macOS, and
BusyBox sed all accept -E.
-i
Apple sed expects an argument for the backup suffix. The empty argument in -i '' means no backup; it
is not the same syntax as GNU's usual suffix-free form. Use a backup until you have verified the
edit.
Common mistakes
The substitution flag g changes every match on a line, not the number of files edited. Replacement text treats & specially: it expands to the matched text. Preview rules containing punctuation carefully.
Portability
In-place editing is not uniform across implementations. The examples below create backup files rather than discarding the original. Version-sensitive extensions are outside the common examples. The Common examples were executed on GNU sed 4.10, macOS sed, and BusyBox 1.37.0 (see the development guide for the exact check).
About macOS sed
This is the sed in /usr/bin on macOS. Its manual carries the same Version 7 history note as the FreeBSD manual, but this page does not claim that it matches any particular FreeBSD version. The difference that matters most in practice is that -i always takes a backup-suffix argument, and an empty one means no backup.
Apple examples
Retain a backup while editing a disposable file:
sed -i '.bak' 's/old/new/g' notes.txt
References
Original explanations, with upstream documentation for further reading. FreeBSD references are comparison material, not a claim of Apple version equivalence.