diff --git a/python/README.md b/python/README.md
index 6d479bee2db..4ee50a3edce 100644
--- a/python/README.md
+++ b/python/README.md
@@ -1,17 +1,12 @@
 This directory contains various Python modules used to support servo
 development.
 
-= mach =
-
-The command dispatch framework used to wrap the build system and test
-harnesses.
-
-= servo =
+# `servo`
 
 servo-specific python code e.g. implementations of mach commands. This
 is the canonical repository for this code.
 
-= tidy =
+# `tidy`
 
 servo-tidy is used to check licenses, line lengths, whitespace, flake8 on
 Python files, lock file versions, and more.