diff --git a/docs/usage.rst b/docs/usage.rst
index 865ede80..f9cdb60c 100644
--- a/docs/usage.rst
+++ b/docs/usage.rst
@@ -23,7 +23,10 @@ Composing mode is entered by either starting ``jrnl`` without any arguments -- w
 
     jrnl today at 3am: I just met Steve Buscemi in a bar! He looked funny.
 
-Note that a shell contains a certain number of reserved characters. Unbalanced quotes, paranthesis, etc will get into the way of your editing. If you need to edit a text which is a bit longer and is likely to contain the reserved characters, you are better to just type `jrnl`and `return`. Only then enter the text of your journal entry. Or you might want to use an external editor (see below).
+
+.. note::
+
+    Most shell contains a certain number of reserved characters, such as ``#`` and ``*``. Unbalanced quotes, parenthesis, and so on will also get into the way of your editing. For writing longer entries, just enter ``jrnl`` and hit ``return``. Only then enter the text of your journal entry. Alternatively, :doc:`use an external editor <advanced>`).
 
 You can also import an entry directly from a file::