diff --git a/doc/ref/sxml.texi b/doc/ref/sxml.texi
index 3502c3f1a..fceb30655 100644
--- a/doc/ref/sxml.texi
+++ b/doc/ref/sxml.texi
@@ -204,6 +204,21 @@ the current output port, unless the optional argument @var{port} is
present.
@end deffn
+Output is automatically escaped as expected for a serializer.
+
+@example
+(sxml->xml `(code "Some example"))
+@result{} <i>Some example</i>
+@end example
+
+In order to avoid some string from being escaped, it must be wrapped in a
+procedure that writes the string to the @code{(current-output-port)}.
+
+@example
+(sxml->xml `(code ,(lambda () (display "Some example"))))
+@result{} Some example
+@end example
+
@deffn {Scheme Procedure} sxml->string sxml
Detag an sxml tree @var{sxml} into a string. Does not perform any
formatting.