diff --git a/doc/05-repositories.md b/doc/05-repositories.md
index 369c46e14..285465572 100644
--- a/doc/05-repositories.md
+++ b/doc/05-repositories.md
@@ -551,8 +551,8 @@ Typically, you would leave the source part off, as you don't really need it.
 If a source key is included, the reference field should be a reference to the version that will be installed.
 Where the type field is `git`, this will the be the commit id, branch or tag name.
 
-**Note**: It is not recommended to use a git branch name for the reference field. While this is valid since it is supported by `git checkout`,
-branch names are mutable so cannot be locked.
+> **Note**: It is not recommended to use a git branch name for the reference field. While this is valid since it is supported by `git checkout`,
+> branch names are mutable so cannot be locked.
 
 Where the type field is `svn`, the reference field should contain the reference that gets appended to the URL when running `svn co`.