diff --git a/README.md b/README.md
index bdc94b4..b303474 100644
--- a/README.md
+++ b/README.md
@@ -1,21 +1,14 @@
 # abe-replace-variable
 
-Edit:
-
-Edit references: `abe-variable-references.json`
-
-add a reference: 
+## Usage
 
+Add a reference in `abe-variable-references.json` file:
 ```json
 {
-	"$$firstname": "john doe"
+    "$$firstname": "john doe"
 }
 ```
 
-Example:
-
-into input type text write `hello $$firstname`
-
-# Publish
+Into input type text write `hello $$firstname`.
 
-when the post is published `hello $$firstname` will be replaced by `john doe`
+When the post is published `hello $$firstname` will be replaced by `john doe`.