diff --git a/docs/.vuepress/config.js b/docs/.vuepress/config.js
index c5ab8362c3..e02c495b5d 100644
--- a/docs/.vuepress/config.js
+++ b/docs/.vuepress/config.js
@@ -3,7 +3,7 @@ const container = require('markdown-it-container')
 module.exports = {
   markdown: {
     anchor: {
-      permalink: false,
+      permalink: true,
     },
     config: md => {
       md
diff --git a/docs/1.x.x/README.md b/docs/1.x.x/README.md
index 81fb51d86b..f1c9496438 100644
--- a/docs/1.x.x/README.md
+++ b/docs/1.x.x/README.md
@@ -1,8 +1,11 @@
-# Strapi [![Build Status](https://travis-ci.org/wistityhq/strapi.svg?branch=master)](https://travis-ci.org/wistityhq/strapi) [![Slack Status](http://strapi-slack.herokuapp.com/badge.svg)](http://slack.strapi.io)
+::: intro
+# Strapi 
 
-[Website](http://strapi.io/) - [Getting Started](#user-content-getting-started-in-a-minute) - [Documentation](http://strapi.io/documentation/introduction) - [Support](http://strapi.io/support)
+[![Build Status](https://travis-ci.org/wistityhq/strapi.svg?branch=master)](https://travis-ci.org/wistityhq/strapi) 
+[![Slack Status](http://strapi-slack.herokuapp.com/badge.svg)](http://slack.strapi.io)
 
 Strapi is an open-source Node.js rich framework for building applications and services.
+:::
 
 Strapi enables developers to focus on writing reusable application logic instead of spending time
 building infrastructure. It is designed for building practical, production-ready Node.js applications
@@ -111,11 +114,10 @@ Strapi comes with a simple but yet powerful dashboard.
 
 ## Resources
 
-- [Roadmap](ROADMAP.md)
-- [Contributing guide](CONTRIBUTING.md)
-- [MIT License](LICENSE.md)
+- [Contributing guide]((https://github.com/strapi/strapi/blob/master/CONTRIBUTING.md))
+- [MIT License]((https://github.com/strapi/strapi/blob/master/LICENSE.md))
 
 ## Links
 
-- [Strapi website](http://strapi.io/)
+- [Strapi website](https://strapi.io/)
 - [Strapi news on Twitter](https://twitter.com/strapijs)
diff --git a/docs/3.x.x/README.md b/docs/3.x.x/README.md
index bf918349dd..04c5d1f289 100644
--- a/docs/3.x.x/README.md
+++ b/docs/3.x.x/README.md
@@ -1,4 +1,5 @@
-![Logo](https://cldup.com/7umchwdUBh.png)<!-- {.text-center} -->
+::: intro
+![Logo](https://cldup.com/7umchwdUBh.png)
 
 ### API creation made simple, secure and fast.
 The most advanced open-source Content Management Framework to build powerful API with no effort.
@@ -8,6 +9,8 @@ The most advanced open-source Content Management Framework to build powerful API
 [![Build status](https://travis-ci.org/strapi/strapi.svg?branch=master)](https://travis-ci.org/strapi/strapi)
 [![Slack status](http://strapi-slack.herokuapp.com/badge.svg)](http://slack.strapi.io)
 [![Heroku Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/strapi/strapi-heroku-app)<!-- {height=20} -->
+<!-- {p:.flex.justify-around} -->
+:::
 
 ## v3@alpha.13 is available!
 We've been working on a major update for Strapi during the past months, rewriting the core framework and the dashboard.