diff --git a/src/scanner/mod.rs b/src/scanner/mod.rs
index b1c3e37..9487f8e 100644
--- a/src/scanner/mod.rs
+++ b/src/scanner/mod.rs
@@ -924,7 +924,7 @@ impl Scanner
     }
 
     /// Chomp whitespace and optionally comments until we
-    /// reach the next token, updating buffer[0] to the
+    /// reach the next token, updating .buffer to the
     /// beginning of the new token
     fn eat_whitespace(&mut self, opts: Flags, buffer: &mut &str, comments: bool) -> Result<usize>
     {
diff --git a/src/scanner/tag.rs b/src/scanner/tag.rs
index 5fd4613..7b35d10 100644
--- a/src/scanner/tag.rs
+++ b/src/scanner/tag.rs
@@ -430,8 +430,7 @@ where
     }
 }
 
-/// Helper function for constructing
-/// [Ref][Ref]<[Token::Tag][Token]>s
+/// Helper function for constructing [Token::Tag](Token)s
 fn assemble_tag<'de>(handle: &'de str, suffix: Slice<'de>, can_borrow: bool) -> Token<'de>
 {
     if can_borrow
diff --git a/src/token.rs b/src/token.rs
index d98665a..3b1d869 100644
--- a/src/token.rs
+++ b/src/token.rs
@@ -11,9 +11,9 @@ pub type Slice<'a> = std::borrow::Cow<'a, str>;
 pub enum Token<'a>
 {
     /// The stream's start, with the byte (encoding)
-    /// [virtual]
+    /// {virtual}
     StreamStart(StreamEncoding),
-    /// The stream's end [virtual]
+    /// The stream's end {virtual}
     StreamEnd,
     /// The %YAML directive, (major,minor)
     VersionDirective(u8, u8),
@@ -99,9 +99,9 @@ impl<'a> Token<'a>
 pub enum Marker
 {
     /// The stream's start, with the byte (encoding)
-    /// [virtual]
+    /// {virtual}
     StreamStart,
-    /// The stream's end [virtual]
+    /// The stream's end {virtual}
     StreamEnd,
     /// The %YAML directive, (major,minor)
     VersionDirective,