The Sass Parser will drop starting whitespace on single line comments so the | char can be used to work around that in the docs.

doc-src/lib/stylesheets/sass_extensions.rb

@@ -154,7 +154,7 @@ module Sass
         docstring.gsub(/@doc off(.*?)@doc on/m, '')
       end
       def docstring
-        ([value] + lines).join("\n")
+        ([value] + lines).join("\n").gsub(/(^\| )|(^\|$)/, '')
       end
       def doc
         if value == "@doc off"

frameworks/blueprint/stylesheets/blueprint/_ie.sass

@@ -1,21 +1,30 @@
+// @doc off
 // The blueprint IE mixins should be mixed into a stylesheet that gets conditionally included
 // into IE like so:
 // <!--[if lt IE 8]><link rel="stylesheet" href="ie.css"
 //                   type="text/css" media="screen, projection"><![endif]-->
+// @doc on
 
-
+//| Usage Examples
-// Usage examples:
+//| --------------
-// As a top-level mixin, apply to any page that includes the stylesheet:
+//|
-//   +blueprint-ie
+//| As a top-level mixin, apply to any page that includes the stylesheet:
-// Scoped by a presentational class:
+//|
-//   body.blueprint
+//|     +blueprint-ie
-//    +blueprint-ie(true)
+//|
-// Scoped by semantic selectors:
+//| Scoped by a presentational class:
-//   body#page-1, body#page-2, body.a-special-page-type
+//|
-//     +blueprint-ie(true)
+//|     body.blueprint
-// Deprecated:
+//|      +blueprint-ie(true)
-//   You can pass the body selector as the first argument when used as a top-level mixin
+//|
-//   +blueprint-ie("body#page-1, body#page-2, body.a-special-page-type")
+//| Scoped by semantic selectors:
+//|
+//|     body#page-1, body#page-2, body.a-special-page-type
+//|       +blueprint-ie(true)
+//|
+//| **Deprecated:** You can pass the body selector as the first argument when used as a top-level mixin
+//|
+//|     +blueprint-ie("body#page-1, body#page-2, body.a-special-page-type")
 =blueprint-ie(!body_selector = "body")
   @if !body_selector == true
     +blueprint-ie-body