diff --git a/README.md b/README.adoc
similarity index 63%
rename from README.md
rename to README.adoc
index 7c628ef55..579d70b3c 100644
--- a/README.md
+++ b/README.adoc
@@ -1,29 +1,29 @@
-Register a Function:
+== Register a Function:
 
-```
+----
 ./register.sh -n uppercase -f "f->f.map(s->s.toString().toUpperCase())"
-```
+----
 
-Run a Stream Processing Microservice using that Function:
+== Run a Stream Processing Microservice using that Function:
 
-```
+----
 ./stream.sh -i words -o uppercaseWords -f uppercase
-```
+----
 
-Run a REST Microservice using that Function:
+== Run a REST Microservice using that Function:
 
-```
+----
 ./web.sh -p /words -f uppercase
-```
+----
 
-To compose Functions:
+== Compose Functions:
 
 (assuming the `uppercase` function was already registered as above)
 
-```
+----
 ./register.sh -n pluralize -f "f->f.map(s->s+\"S\")"
 
 ./web.sh -p /words -f uppercase,pluralize
-```
+----
 
 (more docs soon)