diff --git a/doc/org-roam.org b/doc/org-roam.org
index b621271..f946d9b 100644
--- a/doc/org-roam.org
+++ b/doc/org-roam.org
@@ -729,11 +729,14 @@ to variable ~company-backends~.
 represents the cursor:
 
 - ~[[|]]~: completes for a file title
-- ~[[roam:]]~: completes for a file title
+- ~[[roam:|]]~: completes for a file title
 - ~[[*|]]~: completes for a headline within this file
 - ~[[foo*|]]~: completes a headline within the file with title "foo"
 - ~[[roam:foo*|]]~ completes a headline within the file with title "foo"
 
+If you don't see the literal display of your links like the above examples,
+call ~M-x org-toggle-link-display~
+
 Completions account for the current input. For example, for ~[[f|]]~, the
 completions (by default) only show for files with titles that start with "f".
 
diff --git a/doc/org-roam.texi b/doc/org-roam.texi
index 35bbd18..c1cfea0 100644
--- a/doc/org-roam.texi
+++ b/doc/org-roam.texi
@@ -1143,7 +1143,7 @@ represents the cursor:
 @code{[[|]]}: completes for a file title
 
 @item
-@code{[[roam:]]}: completes for a file title
+@code{[[roam:|]]}: completes for a file title
 
 @item
 @code{[[*|]]}: completes for a headline within this file
@@ -1155,6 +1155,9 @@ represents the cursor:
 @code{[[roam:foo*|]]} completes a headline within the file with title ``foo''
 @end itemize
 
+If you don't see the literal display of your links like the above examples,
+call @code{M-x org-toggle-link-display}
+
 Completions account for the current input. For example, for @code{[[f|]]}, the
 completions (by default) only show for files with titles that start with ``f''.