diff --git a/keyboards/MMD-KM17/readme.md b/keyboards/MMD-KM17/readme.md
new file mode 100644
index 00000000000..8668fedfc63
--- /dev/null
+++ b/keyboards/MMD-KM17/readme.md
@@ -0,0 +1,22 @@
+# MMD-KM17
+
+
+* A customizable soldering 75% keyboard.
+
+* Keyboard Maintainer: JACKY(https://github.com/JackyJia73)
+* Hardware Supported: MMD-KM17
+* Hardware Availability: [MMD-KM17](https://github.com/Smartmmd/qmk_firmware/new/master/keyboards)
+
+Make example for this keyboard (after setting up your build environment):
+
+    make MMD-KM17:default
+Flashing example for this keyboard:
+
+    make MMD-KM17:default:flash
+
+See the build environment setup and the make instructions for more information. Brand new to QMK? Start with our Complete Newbs Guide.
+
+## Bootloader ESC the bootloader in 3 ways:
+* **Bootmagic reset: Hold down Enter in the keyboard then replug
+* **Physical reset button: Briefly press the button on the back of the PCB
+* **Keycode in layout: Press the key mapped to QK_BOOT