diff --git a/plugins/magic-enter/Readme.md b/plugins/magic-enter/Readme.md
index b401ab415..78514c67d 100644
--- a/plugins/magic-enter/Readme.md
+++ b/plugins/magic-enter/Readme.md
@@ -1,14 +1,17 @@
-## Magic Enter
+## Magic Enter plugin
 
-**Maintainer:** [@dufferzafar](https://github.com/dufferzafar)
+This plugin makes your enter key magical, by binding commonly used commands to it.
 
-Makes your enter key magical, by binding commonly used commands to it.
+To use it, add `magic-enter` to the plugins array in your zshrc file. You can set the
+commands to be run in your .zshrc, before the line containing plugins. If no command
+is specified in a git directory, `git status` is executed; in other directories, `ls`.
 
-You can set the commands to be run in your .zshrc, before the line containing plugins!
-
-```bash
+```zsh
+# defaults
 MAGIC_ENTER_GIT_COMMAND='git status -u .'
 MAGIC_ENTER_OTHER_COMMAND='ls -lh .'
 
-plugins=(magic-enter)
+plugins=(... magic-enter)
 ```
+
+**Maintainer:** [@dufferzafar](https://github.com/dufferzafar)