diff --git a/keymap-drawer/keymap-reference.md b/keymap-drawer/keymap-reference.md
new file mode 100644
index 0000000..545bbde
--- /dev/null
+++ b/keymap-drawer/keymap-reference.md
@@ -0,0 +1,82 @@
+# Keymap Reference
+
+## Key Positions
+
+```
+ 0  1  2  3  4  5  |  6  7  8  9 10 11
+12 13 14 15 16 17  | 18 19 20 21 22 23
+24 25 26 27 28 29  | 30 31 32 33 34 35
+         36 37 38  | 39 40 41
+```
+
+## Layer 0: CARP (Carpalx QGMLWY)
+
+```
+`      Q  G  M  L  W  |  Y  F  U  B  ;    ->HUB
+[HUB]  D  S  T  N  R  |  I  A  E  O  H    '
+LSHFT  Z  X  C  V  J  |  K  P  ,  .  /    RSHFT
+        [RGB]  CTRL  GUI | SPC  ALT  MUTE/PP
+```
+
+**Combos (layers 0+1):**
+- Top+home row same col = `1`-`0`, shift+combo = `!` `@` `#` `$` `%` `^` `&` `*` `(` `)`
+- G+M (W+E on QWRT) = ESC
+- S+T (S+D on QWRT) = TAB
+- U+B (I+O on QWRT) = BSPC
+- E+O (K+L on QWRT) = ENTER
+
+| Key | Behavior |
+|-----|----------|
+| `[HUB]` | Hold opens HUB layer, release goes back |
+| `[RGB]` | Tap-dance: 1x=toggle, 2x=effect fwd, 3x=effect rev |
+| `MUTE/PP` | Tap mute, hold play/pause |
+
+## Layer 1: QWRT (QWERTY)
+
+```
+`      Q  W  E  R  T  |  Y  U  I  O  P    ->HUB
+[HUB]  A  S  D  F  G  |  H  J  K  L  ;    '
+LSHFT  Z  X  C  V  B  |  N  M  ,  .  /    RSHFT
+        [RGB]  CTRL  GUI | SPC  ALT  MUTE/PP
+```
+
+Combos: same as CARP (top+home = 1-0, W+E = ESC, S+D = TAB, I+O = BSPC, K+L = ENTER)
+
+## Layer 2: STEN (Placeholder)
+
+Reserved for steno engine. Currently all `&none`.
+
+## Layer 3: FPS (WASD shifted right for ortho)
+
+```
+1/ESC  2     Q  [W]  E/3   R/4  | 5    6    7    8    9    ->HUB
+TAB    SHFT [A] [S] [D]    F    | _    _    _    _    _    _
+M/ALT  Z     X   C   V     G    | _    _    _    _    _    _
+              T     CTRL  SPC   | _    _    _
+```
+
+| Key | Behavior |
+|-----|----------|
+| `1` | Tap = 1, hold = ESC |
+| `E` | Tap = E, hold = 3 |
+| `R` | Tap = R, hold = 4 |
+| `M` | Tap = M, hold = ALT |
+
+## Layer 4: HUB (Utility — BT, RGB, Media, Nav)
+
+```
+BT_CLR BT0    BT1    BT2    BT3     BT4     | +      [     UP    ]     *    =
+OUT_TOG HUE+  SAT+   BRT+   SCRN+   VOL+    | -      LEFT  DOWN  RIGHT /    \
+LSHFT  HUE-   SAT-   BRT-   SCRN-   VOL-    | ->CARP ->QWRT ->STEN ->FPS [CLR] RSHFT
+             [RGB]    CTRL   GUI              | SPC    ALT   MUTE/PP
+```
+
+| Key | Action |
+|-----|--------|
+| `OUT_TOG` | Toggle USB/BLE output |
+| `HUE/SAT/BRT` | RGB underglow hue, saturation, brightness |
+| `SCRN` | Display brightness (C_BRI_UP/DN) |
+| `VOL` | Volume up/down |
+| `[RGB]` | Tap-dance: 1x=toggle, 2x=effect fwd, 3x=effect rev |
+| `[CLR]` | Tap-dance color presets: 1x=purple, 2x=white, 3x=red, 4x=blue, 5x=green |
+| `MUTE/PP` | Tap mute, hold play/pause |
diff --git a/keymap-drawer/keymap-reference.txt b/keymap-drawer/keymap-reference.txt
deleted file mode 100644
index a439f8d..0000000
--- a/keymap-drawer/keymap-reference.txt
+++ /dev/null
@@ -1,60 +0,0 @@
-Key positions reference:
-
- 0  1  2  3  4  5  |  6  7  8  9 10 11
-12 13 14 15 16 17  | 18 19 20 21 22 23
-24 25 26 27 28 29  | 30 31 32 33 34 35
-         36 37 38  | 39 40 41
-
-
-Layer 0: CARP (Carpalx QGMLWY)
-
-`      Q  G  M  L  W  |  Y  F  U  B  ;    ->HUB
-[HUB]  D  S  T  N  R  |  I  A  E  O  H    '
-LSHFT  Z  X  C  V  J  |  K  P  ,  .  /    RSHFT
-        [RGB]  CTRL  GUI | SPC  ALT  MUTE/PP
-
-Combos (layers 0+1):
-  top+home row same col = 1-0, shift+combo = ! @ # $ % ^ & * ( )
-  G+M (W+E on QWRT) = ESC
-  S+T (S+D on QWRT) = TAB
-  U+B (I+O on QWRT) = BSPC
-  E+O (K+L on QWRT) = ENTER
-[HUB] = hold opens HUB layer, release goes back
-[RGB] = tap-dance: 1x=toggle, 2x=effect fwd, 3x=effect rev
-MUTE/PP = tap mute, hold play/pause
-
-
-Layer 1: QWRT (QWERTY)
-
-`      Q  W  E  R  T  |  Y  U  I  O  P    ->HUB
-[HUB]  A  S  D  F  G  |  H  J  K  L  ;    '
-LSHFT  Z  X  C  V  B  |  N  M  ,  .  /    RSHFT
-        [RGB]  CTRL  GUI | SPC  ALT  MUTE/PP
-
-Combos: same as CARP (top+home = 1-0, W+E = ESC, S+D = TAB, I+O = BSPC, K+L = ENTER)
-
-
-Layer 2: FPS (WASD shifted right for ortho)
-
-1/ESC  2     Q  [W]  E/3   R/4  | 5    6    7    8    9    ->HUB
-TAB    SHFT [A] [S] [D]    F    | _    _    _    _    _    _
-M/ALT  Z     X   C   V     G    | _    _    _    _    _    _
-              T     CTRL  SPC   | _    _    _
-
-Hold-taps: 1=tap/ESC=hold, E=tap/3=hold, R=tap/4=hold, M=tap/ALT=hold
-
-
-Layer 3: HUB (Utility — BT, RGB, Media, Nav)
-
-BT_CLR BT0    BT1    BT2    BT3     BT4     | +      [     UP    ]     *    =
-OUT_TOG HUE+  SAT+   BRT+   SCRN+   VOL+    | -      LEFT  DOWN  RIGHT /    \
-LSHFT  HUE-   SAT-   BRT-   SCRN-   VOL-    | ->CARP ->QWRT ->FPS _     [CLR] RSHFT
-             [RGB]    CTRL   GUI              | SPC    ALT   MUTE/PP
-
-OUT_TOG = toggle USB/BLE output
-HUE/SAT/BRT = RGB underglow hue, saturation, brightness
-SCRN = display brightness (C_BRI_UP/DN)
-VOL = volume up/down
-[RGB] = tap-dance: 1x=toggle, 2x=effect fwd, 3x=effect rev
-[CLR] = tap-dance color presets: 1x=purple, 2x=white, 3x=red, 4x=blue, 5x=green
-MUTE/PP = tap mute, hold play/pause