diff --git a/about.md b/about.md
index 9b378418cede5617e985c66d3214164630e8f128..d6754e120aa2ffc75705c2526e18268d97761f20 100644
--- a/about.md
+++ b/about.md
@@ -7,7 +7,7 @@ order: 2
 
 Here you would normally put your contact information.
 
-~~~
+---
 
 You can find out more info about customizing your Jekyll theme, as well as basic Jekyll usage documentation at [jekyllrb.com](https://jekyllrb.com/)
 
diff --git a/index.md b/index.md
index f5809e9870b02df8a3b30ee128b7e684162f39e4..0650a24ae49b22a9d98b503bbefa5dc47027095a 100644
--- a/index.md
+++ b/index.md
@@ -17,23 +17,16 @@ If you are interested, have found any issues with the layout or have a helpful s
 1. [Create an empty repository in Gitlab](https://git-r3lab.uni.lu/projects/new). Please bear in mind, that the both names of the namespace and the project influence 
     final address of the page - it will internally follow the `https://<namespace>.pages.uni.lu/<project_name>` convention. (Note, that in the very last step, SIU can set a new alias/URL for your website)
     ![image](assets/screenshots/new_project.png)
-2. On your computer, clone this very repository using: ```git clone ssh://git@git-r3lab-server.uni.lu:8022/core-services/pages-jekyll-lcsb-template.git```.
-3. Once cloned, navigate into cloned repository and remove the _remote_ (so that you update your repository, and not this very page):
-```cd pages-jekyll-lcsb-template
-git remote rm origin
-```, and add _remote_ to your repository. 
-```
-git remote add <HERE PASTE YOUR REMOTE URL, AS SHOWN BELOW>
-# e.g. git remote add origin ssh://git@git-r3lab-server.uni.lu:8022/firstname.surname/your_projects_name.git
-```
-You can find the correct remote address in gitlab, as in the following image:
+2. On your computer, clone this very repository using: `git clone ssh://git@git-r3lab-server.uni.lu:8022/core-services/pages-jekyll-lcsb-template.git`.
+3. Once cloned, navigate into cloned repository (`cd pages-jekyll-lcsb-template`) and remove the _remote_ - `git remote rm origin` (so that you update your repository, and not this very page).
+4. Set a new remote (so that you push to your new repository) - `git remote add origin ssh://git@git-r3lab-server.uni.lu:8022/firstname.surname/your_projects_name.git`. You can find the correct remote address in Gitlab just after creating new repository, as in the following image:
  ![image](assets/screenshots/remote.png)
-4. Modify site's settings (`_config.yml`) to match your needs. Refer to the next section for help.
-5. Modify the index page. Modify (or delete) help and about pages. Add your own content. 
-6. Add your changes (`git add .`), commit (`git commit -m "Initial commit"`) and push (`git push --set-upstream master`) to the repository.
-7. Your page is published! Go to `https://<namespace>.pages.uni.lu/name-of-repository` in your favourite browser, or the URL you specified in the SIU ticket.
-8. In gitlab, go to **Settings** (under left-hand menu) > **General** > **Advanced** (hit `Expand` button) > **Remove fork relationship** (red button), then follow the instructions from the pop-up.
-9. If you want to have your page publicly available - contact us  (`lcsb-sysadmins (at) uni.lu`), we will make a ticket to SIU.
+5. Modify site's settings (`_config.yml`) to match your needs. Refer to the next section for help.
+6. Modify the index page. Modify (or delete) help and about pages. Add your own content. 
+7. Add your changes (`git add .`), commit (`git commit -m "Initial commit"`) and push (`git push --set-upstream master`) to the repository.
+8. Your page is published! Go to `https://<namespace>.pages.uni.lu/name-of-repository` in your favourite browser, or the URL you specified in the SIU ticket.
+9. In gitlab, go to **Settings** (under left-hand menu) > **General** > **Advanced** (hit `Expand` button) > **Remove fork relationship** (red button), then follow the instructions from the pop-up.
+10. If you want to have your page publicly available - contact us  (`lcsb-sysadmins (at) uni.lu`), we will make a ticket to SIU.
 
 ## What should you change in settings file?
 We used to require a change in `url` and `baseurl` - but not anymore :)