diff --git a/README.adoc b/README.adoc
index b82597f2..99a29698 100644
--- a/README.adoc
+++ b/README.adoc
@@ -238,10 +238,10 @@ running locally (e.g. mongo or rabbit).  Ignore the git-related bits
 that you might find in "before_install" since they will be able git
 credentials and you already have those.
 
-If you need mongo, rabbit or redis, see the README in the [scripts
-demo repository](https://github.com/spring-cloud-samples/scripts) for
+If you need mongo, rabbit or redis, see the README in the https://github.com/spring-cloud-samples/scripts[scripts
+demo repository] for
 instructions. For example consider using the "fig.yml" with
-[Fig](http://www.fig.sh/) to run them in Docker containers.
+http://www.fig.sh[Fig] to run them in Docker containers.
 
 == Documentation
 
@@ -319,4 +319,4 @@ The generated eclipse projects can be imported by selecting `import existing pro
 from the `file` menu.
 
 === Importing into other IDEs
-Maven is well supported by most Java IDEs. Refer to you vendor documentation.
\ No newline at end of file
+Maven is well supported by most Java IDEs. Refer to you vendor documentation.