diff --git a/doc/src/sgml/README.links b/doc/src/sgml/README.links
index 388fdc6ee6..db6577d243 100644
--- a/doc/src/sgml/README.links
+++ b/doc/src/sgml/README.links
@@ -40,6 +40,10 @@ url=
Guidelines
----------
-o If you want to supply text, use , else
-o Specific nouns like GUC variables, SQL commands, and contrib modules
- usually have xreflabels
+- For an internal link, if you want to supply text, use , else
+ .
+
+- Specific nouns like GUC variables, SQL commands, and contrib modules
+ usually have xreflabels.
+
+- For an external link, use , with or without link text.