diff --git a/versions/3.0.4.md b/versions/3.0.4.md
index 12b2375a79..5a035a9e1e 100644
--- a/versions/3.0.4.md
+++ b/versions/3.0.4.md
@@ -212,6 +212,8 @@ Relative references are resolved using the URLs defined in the [`Server Object`]
 
 Relative references used in `$ref` are processed as per [JSON Reference](https://tools.ietf.org/html/draft-pbryan-zyp-json-ref-03), using the URL of the current document as the base URI. See also the [Reference Object](#referenceObject).
 
+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.