diff --git a/README.md b/README.md
index 79102ecb94441964e35b66bac0ef77b201124f99..3344f166e620657d780b8dcf1b77c26e1fba12c3 100644
--- a/README.md
+++ b/README.md
@@ -17,10 +17,17 @@ > not been tampered with.
 
 ## Controller mappings
 
-```
-  Q W E      I O
-  A S D      J k
-```
+
+| Button           | Keyboard | Xbox | Playstation | Nintendo |
+|------------------|----------|------|-------------|----------|
+| button.PAD_UP    | W        | N/A  |             |          |
+| button.PAD_DOWN  | S        | N/A  |             |          |
+| button.PAD_LEFT  | A        | N/A  |             |          |
+| button.PAD_RIGHT | D        | N/A  |             |          |
+| button.A         | L        | N/A  |             |          |
+| button.B         | P        | N/A  |             |          |
+| button.X         | K        | N/A  |             |          |
+| button.Y         | O        | N/A  |             |          |
 
 ## Tools