diff --git a/README.md b/README.md
index 7b38b224386cfa33a553cfc204c494706bbcb6df..865d8df821f0b9b68b0f0df51432784ec551c4f4 100644
--- a/README.md
+++ b/README.md
@@ -21,7 +21,7 @@ documentation https://docs.gitlab.com/ce/user/project/pages/.
 This project's static Pages are built by [GitLab CI][ci], following the steps
 defined in [`.gitlab-ci.yml`](.gitlab-ci.yml):
 
-```
+```yml
 image: busybox
 
 pages:
@@ -58,7 +58,7 @@ unless you want to contribute back to the upstream project.
 1. CSS is missing! That means that you have wrongly set up the CSS URL in your
    HTML files. Have a look at the [index.html] for an example.
 
-[ci]: https://about.gitlab.com/gitlab-ci/
-[index.html]: https://gitlab.com/pages/plain-html/blob/master/public/index.html
-[userpages]: https://docs.gitlab.com/ce/user/project/pages/introduction.html#user-or-group-pages
-[projpages]: https://docs.gitlab.com/ce/user/project/pages/introduction.html#project-pages
+[ci]: https://about.gitlab.com/solutions/continuous-integration/
+[index.html]: https://gitlab.com/pages/plain-html/-/blob/main/public/index.html
+[userpages]: https://docs.gitlab.com/ee/user/project/pages/introduction.html#gitlab-pages-in-projects-and-groups
+[projpages]: https://docs.gitlab.com/ee/user/project/pages/introduction.html#gitlab-pages-in-projects-and-groups