diff --git a/docs/syntax/links.md b/docs/syntax/links.md
index 610654fde..508cdfef4 100644
--- a/docs/syntax/links.md
+++ b/docs/syntax/links.md
@@ -16,6 +16,17 @@ A link contains link text (the visible text) and a link destination (the URI tha
 
 [**Hi**, _I'm md_](links.md)
 
+## Link to another page
+
+You can link to another page by pointing to the markdown file.
+This applies to files within the same repo.
+
+```markdown
+[Link text](/solutions/search.md)
+```
+
+Note that they must be prefixed with `/`.
+
 ## Anchor link
 
 You can link to a heading on a page with an anchor link. The link destination should be a `#` followed by the header text. Convert spaces to dashes (`-`).
@@ -102,4 +113,4 @@ Docsbuilder temporary supports the abbility to create a linkable anchor anywhere
 This is text and $$$this-is-an-inline-anchor$$$
 ```
 
-This feature exists to aid with migration however is scheduled for removal and new content should **NOT** utilize this feature.
\ No newline at end of file
+This feature exists to aid with migration however is scheduled for removal and new content should **NOT** utilize this feature.