diff --git a/website/docs/guides/docs/docs-markdown-features.mdx b/website/docs/guides/docs/docs-markdown-features.mdx
index fe2660b212..40be16cb9e 100644
--- a/website/docs/guides/docs/docs-markdown-features.mdx
+++ b/website/docs/guides/docs/docs-markdown-features.mdx
@@ -29,7 +29,7 @@ Reference to another [document in a subfolder](subfolder/doc3.md).
 
 :::tip
 
-It is better to use relative file paths links instead of relative links:
+Using relative _file_ paths (with `.md` extensions) instead of relative _URL_ links provides the following benefits:
 
 - links will keep working on the GitHub interface
 - you can customize the document slugs without having to update all the links