diff --git a/README b/README
index ccd01bba3..de688aa1c 100644
--- a/README
+++ b/README
@@ -2380,6 +2380,10 @@ be followed by a link title, in quotes.)
 There can be no space between the bracketed part and the parenthesized part.
 The link text can contain formatting (such as emphasis), but the title cannot.
 
+Email addresses in inline links are not autodetected, so they have to be
+prefixed with `mailto`:
+
+    [Write me!](mailto:sam@green.eggs.ham)
 
 ### Reference links ###