diff --git a/versions/3.1.1.md b/versions/3.1.1.md
index 06b2883cdb..1281fd927e 100644
--- a/versions/3.1.1.md
+++ b/versions/3.1.1.md
@@ -278,6 +278,8 @@ API endpoints are by definition accessed as locations, and are described by this
 Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [RFC3986](https://tools.ietf.org/html/rfc3986#section-4.2).
 Unless specified otherwise, relative references are resolved using the URLs defined in the [`Server Object`](#serverObject) as a Base URL. Note that these themselves MAY be relative to the referring document.
 
+Relative references in CommonMark hyperlinks are resolved in their rendered context, which might differ from the context of the API description.
+
 ### Schema
 
 In the following description, if a field is not explicitly **REQUIRED** or described with a MUST or SHALL, it can be considered OPTIONAL.