diff --git a/README.md b/README.md
index fb7b494..7979af1 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,85 @@
-This plug-in provides automatic closing of quotes, parenthesis, brackets, etc., besides some other related features that
-should make your time in insert mode a little bit easier, like syntax awareness (will not insert the closing delimiter
-in comments and other configurable regions), <CR> and <Space> expansions (off by default), and some more.
+# delimitMate
 
-Most of the features can be modified or disabled permanently, using global variables, or on a FileType basis, using
-:autocmd.
+> Vim plugin for automatic closing of quotes, parenthesis, brackets, etc.
+
+## Installation
+
+- [plug.vim](https://github.com/junegunn/vim-plug)
+
+```vim
+Plug 'Raimondi/delimitMate'
+```
+
+## Features
+
+### Automatic closing & exiting
+
+```
+  Type     |  You get
+=======================
+   (       |    (|)
+-----------|-----------
+   ()      |    ()|
+-----------|-----------
+(<S-Tab>   |    ()|
+-----------|-----------
+{("<C-G>g  |  {("")}|
+```
+
+### Expansion of space and CR
+
+Expand `<Space>` to:
+
+```
+You start with  |  You get
+==============================
+    (|)         |    ( | )
+```
+
+Expand `<CR>` to:
+
+```
+You start with   |  You get
+==============================
+    (|)         |    (
+                |      |
+                |    )
+```
+
+### Backspace
+
+```
+  What  |      Before       |      After
+==============================================
+  <BS>  |  call expand(|)   |  call expand|
+--------|-------------------|-----------------
+  <BS>  |  call expand( | ) |  call expand(|)
+--------|-------------------|-----------------
+  <BS>  |  call expand(     |  call expand(|)
+        |  |                |
+        |  )                |
+--------|-------------------|-----------------
+ <S-BS> |  call expand(|)   |  call expand(|
+```
+
+### Smart Quotes
+
+```
+ What |    Before    |     After
+=======================================
+  "   |  Text |      |  Text "|"
+  "   |  "String|    |  "String"|
+  "   |  let i = "|  |  let i = "|"
+  'm  |  I|          |  I'm|
+```
+
+### BALANCING MATCHING PAIRS
+
+```
+e.g. typing at the "|": >
+
+ What |    Before    |     After
+=======================================
+  (   |  function|   |  function(|)
+  (   |  |var        |  (|var
+```