diff --git a/README.md b/README.md
index 3ba4d0c0..24baae4c 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,11 @@
 # Smarty 3 template engine
-www.smarty.net
+[smarty.net](https://www.smarty.net/) 
 
 ## Documentation
 
 For documentation see 
-www.smarty.net/docs/en/ 
+[www.smarty.net/docs/en/](https://www.smarty.net/docs/en/) 
+
 ## Distribution repository
 
 > Smarty 3.1.28 introduces run time template inheritance
@@ -16,7 +17,7 @@ Smarty versions 3.1.11 or later are now on github and can be installed with Comp
 
 The "smarty/smarty" package will start at libs/....   subfolder.
 
-To get the latest stable version of Smarty 3.1 use
+To get the latest stable version of Smarty 3.1 use:
 
 ```json
 "require": {
@@ -26,7 +27,7 @@ To get the latest stable version of Smarty 3.1 use
 
 in your composer.json file.
 
-To get the trunk version use
+To get the trunk version use:
 
 ```json
 "require": {
@@ -34,7 +35,7 @@ To get the trunk version use
 }
 ```
 
-For a specific version use something like
+For a specific version use something like:
 
 ```json
 "require": {
@@ -42,7 +43,7 @@ For a specific version use something like
 }
 ```
 
-PHPUnit test can be installed by corresponding composer entries like
+PHPUnit test can be installed by corresponding composer entries like:
 
 ```json
 "require": {
@@ -50,7 +51,7 @@ PHPUnit test can be installed by corresponding composer entries like
 }
 ```
 
-Similar applies for the lexer/parser generator
+Similar applies for the lexer/parser generator.
 
 ```json
 "require": {
@@ -58,7 +59,7 @@ Similar applies for the lexer/parser generator
 }
 ```
 
-Or you could use
+Or you could use:
 
 ```json
 "require": {
@@ -66,6 +67,6 @@ Or you could use
 }
 ```
 
-Which is a wrapper to install all 3 packages
+Which is a wrapper to install all 3 packages.
 
-Composer can also be used for Smarty2 versions 2.6.24 to 2.6.30
+Composer can also be used for Smarty2 versions 2.6.24 to 2.6.30.