diff --git a/docs/ref/utils.txt b/docs/ref/utils.txt
index 22c6c9ee99..cb7c1e8012 100644
--- a/docs/ref/utils.txt
+++ b/docs/ref/utils.txt
@@ -804,6 +804,9 @@ appropriate entities.
 
     Can be called multiple times on a single string.
 
+    For building up fragments of HTML, you should normally be using
+    :func:`django.utils.html.format_html` instead.
+
     String marked safe will become unsafe again if modified. For example::
 
         >>> mystr = '<b>Hello World</b>   '