diff --git a/quad/quad/scribblings/quad.scrbl b/quad/quad/scribblings/quad.scrbl
index 9d92810e..c7f72a09 100644
--- a/quad/quad/scribblings/quad.scrbl
+++ b/quad/quad/scribblings/quad.scrbl
@@ -526,6 +526,8 @@ Columns per page. @racket[column-count] is a positive integer; @racket[column-ga
 
 A block is a paragraph or other rectangular item (say, a blockquote or code block) with paragraph breaks around it.
 
+@margin-note{Block-level attributes are ignored unless the quad is a block-level element. To explicitly promote a quad to a block-level element, use the @racket[display] attribute with value @racket["block"].}
+
 @deftogether[(@defthing[#:kind "attribute" inset-top symbol?]
               @defthing[#:kind "attribute" inset-bottom symbol?]
               @defthing[#:kind "attribute" inset-left symbol?]
@@ -610,6 +612,10 @@ Specify a quad with an image (either @racket{.png} or @racket{.jpeg}). @racket[i
 
 @subsubsection{Other attributes}
 
+@defthing[#:kind "attribute" display symbol?]{
+Sets the display type. Value is a string. Supply @racket["block"] as a value of this attribute to make the quad behave as a block-level element.
+}
+
 @deftogether[(@defthing[#:kind "attribute" font-size symbol?]
               @defthing[#:kind "attribute" font-size-adjust symbol?])]{
 Two ways of setting the point size for text. @racket[font-size] takes a @tech{dimension string}. @racket[font-size-adjust] takes a string representing a percentage (like @racket["120%"] or @racket["1.2"]) and sets the font size to the size of the parent, multiplied by the percentage.