diff --git a/example/Marker.retro b/example/Marker.retro
index 8ece409..50153c7 100644
--- a/example/Marker.retro
+++ b/example/Marker.retro
@@ -7,6 +7,7 @@ to the state it was in prior to the creation of the marker.
 :class:marker (a-)
   compiling? [ compile:lit &class:marker compile:call ]
              [ fetch-next !Dictionary fetch !Heap     ] choose ;
+
 :marker (s-) [ @Heap @Dictionary ] dip d:create , , &class:marker reclass ;
 ~~~
 
diff --git a/example/c-style-comments.retro b/example/c-style-comments.retro
index 1502643..92eac45 100644
--- a/example/c-style-comments.retro
+++ b/example/c-style-comments.retro
@@ -1,9 +1,12 @@
-Support for comments with embedded spaces; this is useful for quickly
-commenting out portions of lines or larger chunks of code during
-debugging.
+# C Style Comments
 
-This provides for C style /* ... */ comments. It works by patching
-`interpret` to make it ignore tokens until the token is */.
+This adds support for comments with embedded spaces. It is useful
+for quickly commenting out portions of lines or larger chunks of
+code during debugging.
+
+Specifically, this provides for C style /* ... */ comments. It
+works by patching `interpret` to make it ignore tokens until the
+token is `*/`.
 
 ~~~
 {{