diff --git a/README.md b/README.md
index 009103f..6a2e7c6 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,11 @@
-# Carmignac — Data Repair Pipeline
+## Carmignac — Data Repair Pipeline
 
 Registrar Account ID repair for AUM and Flows data.  
 Carmignac × ENSAE Data Challenge 2025.
 
 ---
 
-## Problem
+### Problem
 
 AUM and Flows tables must satisfy the stock-flow identity for every `(account, ISIN, month)`:
 
@@ -17,7 +17,7 @@ In practice this identity is violated because Registrar Account IDs change over
 
 ---
 
-## Files
+### Files
 
 | File | Role |
 |------|------|
@@ -28,7 +28,7 @@ In practice this identity is violated because Registrar Account IDs change over
 
 ---
 
-## Usage
+### Usage
 
 Run in order:
 
@@ -58,7 +58,7 @@ python carmignac_analysis.py \
 
 ---
 
-## Outputs
+### Outputs
 
 | File | Content |
 |------|---------|
@@ -75,7 +75,7 @@ python carmignac_analysis.py \
 
 ---
 
-## Key parameters
+### Key parameters
 
 | Parameter | Value | Role |
 |-----------|-------|------|