Clarify absolute links further

elastic · Feb 5, 2025 · 3f02e0c · 3f02e0c
1 parent 5401a08
commit 3f02e0c
Showing 1 changed file with 4 additions and 1 deletion.
diff --git a/docs/syntax/links.md b/docs/syntax/links.md
@@ -26,12 +26,15 @@ Navigate relative to the current file's location:
 
 #### Absolute paths
 
-You can also use absolute paths to link to pages within the same repository:
+You can also use absolute paths to link to pages within the same repository.
+Say you're working on a random page somewhere in the `docs-content` repo. You can link to a page in the `deploy-manage` section like this:
 
 ```markdown
 [API Keys](/deploy-manage/api-keys.md)
 ```
 
+Note the leading `/` before the path.
+
 ### Same-page links (anchors)
 
 Link to sections within the same document using heading anchors prefixed with `#`: