Indentation — Python's Famous Whitespace Rule

Indentation — Python’s Famous Whitespace Rule

In most languages, indentation is decoration. In Python, indentation is the grammar. This single design decision is responsible for both Python’s beautiful readability and the error every beginner meets in week one. Ten minutes here saves you a hundred frustrated searches.

The idea: structure through spacing

Other languages mark “inside the if” with braces:

# C-style languages (NOT Python)
if (age >= 18) {
    print("You can vote");
    print("Bring your ID");
}

Python uses indentation instead:

# Python
if age >= 18:
    print("You can vote")
    print("Bring your ID")

The colon (:) announces “a block is starting.” The indented lines are the block. When indentation returns to the original level, the block ends. No braces, no end keyword — the shape of the code is the logic.

What indentation actually controls

Watch the difference indentation makes:

age = 20

if age >= 18:
    print("You can vote")       # INSIDE the if — only runs when True
print("Welcome!")               # OUTSIDE the if — always runs

Output (age is 20):

You can vote
Welcome!

Now change one line’s indentation:

age = 15

if age >= 18:
    print("You can vote")
    print("Welcome!")           # now INSIDE the if

Output (age is 15):

(nothing — both prints are inside the if, which was False)

Same code, one space of difference, completely different behavior. Indentation isn’t styling — it’s meaning.

The rules (there are only three)

1. Use 4 spaces per level — the official Python standard (PEP 8). VS Code does this automatically when you press Tab.
2. Be consistent — never mix tabs and spaces in the same file. This causes the sneakiest errors in Python (modern Python versions refuse to run such files, thankfully).
3. Every indented block follows a colon — if, for, while, def, class, with all end their line with :.

The errors you’ll meet (and how to read them)

IndentationError: expected an indented block

if age >= 18:
print("You can vote")      # ← needs 4 spaces

Python expected an indented block after the colon and found none. Fix: indent the line.

IndentationError: unexpected indent

print("hello")
    print("world")     # ← why is this indented? Nothing opened a block

A line is indented with no reason. Fix: remove the indentation.

IndentationError: unindent does not match any outer indentation level

Two blocks ended at different indent levels. Usually a mix of tab and spaces, or 3 spaces in one place and 4 in another. Fix: re-indent the block uniformly (select it in VS Code, Shift+Tab to dedent, Tab to indent).

Let VS Code do the work

• Pressing Enter after a : auto-indents the next line
• Tab indents selected lines; Shift+Tab dedents them
• View → Appearance → Render Whitespace shows exactly what’s in your file when things get confusing

✅ Checkpoint

1. What does a colon at the end of a line mean? (An indented block is starting)
2. How many spaces per level is the standard? (4)
3. In the two-version example, what changed the output? (One print moved from outside the if to inside — indentation is logic)
4. What usually causes “unindent does not match any outer indentation level”? (Mixing tabs with spaces, or inconsistent space counts)

Next: virtual environments — the last building block before variables, and the habit that separates careful coders from chaotic ones.