diff --git a/doc/rdoc/markup_reference.rb b/doc/rdoc/markup_reference.rb
index ee585b2497..97293d5cba 100644
--- a/doc/rdoc/markup_reference.rb
+++ b/doc/rdoc/markup_reference.rb
@@ -859,10 +859,10 @@
 #   - On-page: <tt>DummyClass</tt> links to DummyClass.
 #   - Off-page: <tt>RDoc::Alias</tt> links to RDoc::Alias.
 #
-#   Note: For poeple want to mark up code (such as class, module,
+#   note: When marking up code (such as class, module,
 #   constant, and method) as "<tt>+code+</tt>" (for interoperability
-#   with other MarkDown parsers mainly), such word that refers a known
-#   code object and is marked up entirely and separately as "monofont"
+#   with other MarkDown parsers mainly), any word that refers to a known
+#   code object, and is marked up entirely and separately as "monofont",
 #   is also converted to a link.
 #
 #   - <tt>+DummyClass+</tt> links to DummyClass