diff --git a/README.md b/README.md
index be23e25..4f6956a 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # meta-raspberrypi
 
-Yocto BSP layer for the Raspberry Pi boards - http://www.raspberrypi.org/ .
+Yocto BSP layer for the Raspberry Pi boards - <http://www.raspberrypi.org/>.
 
 [![Build Status](https://yocto-ci.resin.io/job/meta-raspberrypi1/badge/icon)](https://yocto-ci.resin.io/job/meta-raspberrypi1)
 [![Build Status](https://yocto-ci.resin.io/job/meta-raspberrypi2/badge/icon)](https://yocto-ci.resin.io/job/meta-raspberrypi2)
@@ -9,15 +9,17 @@ Yocto BSP layer for the Raspberry Pi boards - http://www.raspberrypi.org/ .
 
 ## Quick links
 
-* Git repository web frontend: http://git.yoctoproject.org/cgit/cgit.cgi/meta-raspberrypi/
-* Mailing list (yocto mailing list): yocto@yoctoproject.org
-* Issues management (Github Issues): https://github.com/agherzan/meta-raspberrypi/issues
+* Git repository web frontend:
+  <http://git.yoctoproject.org/cgit/cgit.cgi/meta-raspberrypi/>
+* Mailing list (yocto mailing list): <yocto@yoctoproject.org>
+* Issues management (Github Issues):
+  <https://github.com/agherzan/meta-raspberrypi/issues>
 
 ## Description
 
 This is the general hardware specific BSP overlay for the RaspberryPi device.
 
-More information can be found at: http://www.raspberrypi.org/ (Official Site)
+More information can be found at: <http://www.raspberrypi.org/> (Official Site)
 
 The core BSP part of meta-raspberrypi should work with different
 OpenEmbedded/Yocto distributions and layer stacks, such as:
diff --git a/docs/contributing.md b/docs/contributing.md
index 728b00e..94dbf49 100644
--- a/docs/contributing.md
+++ b/docs/contributing.md
@@ -3,8 +3,8 @@
 ## Mailing list
 
 The main communication tool we use is a mailing list:
-* yocto@yoctoproject.org
-* https://lists.yoctoproject.org/listinfo/yocto
+* <yocto@yoctoproject.org>
+* <https://lists.yoctoproject.org/listinfo/yocto>
 
 Feel free to ask any kind of questions but always prepend your email subject
 with "[meta-raspberrypi]". This is because we use the 'yocto' mailing list and
@@ -13,10 +13,10 @@ not a perticular 'meta-raspberrypi' mailing list.
 ## Patches and pull requests
 
 All the contributions should be compliant with the openembedded patch
-guidelines: http://www.openembedded.org/wiki/Commit_Patch_Message_Guidelines
+guidelines: <http://www.openembedded.org/wiki/Commit_Patch_Message_Guidelines>
 
 To contribute to this project you should send pull requests to the github mirror
-(https://github.com/agherzan/meta-raspberrypi). **Additionally** you can send
+(<https://github.com/agherzan/meta-raspberrypi>). **Additionally** you can send
 the patches for review to the above specified mailing list.
 
 When creating patches for the mailing list, please use something like:
@@ -30,7 +30,7 @@ When sending patches to the mailing list, please use something like:
 ## Github issues
 
 In order to manage and trace the meta-raspberrypi issues, we use github issues:
-https://github.com/agherzan/meta-raspberrypi/issues
+<https://github.com/agherzan/meta-raspberrypi/issues>
 
 If you push patches which have a github issue associated, please provide the
 issue number in the commit log just before "Signed-off-by" line(s). Example line