diff --git a/docs/authoring/cross-references-divs.qmd b/docs/authoring/cross-references-divs.qmd
index 504baf931..7dee39fd9 100644
--- a/docs/authoring/cross-references-divs.qmd
+++ b/docs/authoring/cross-references-divs.qmd
@@ -136,6 +136,23 @@ In the above example, you can reference the figure with `@fig-line-plot`, but no
 
 {{< include _cross-reference-divs-table.qmd >}}
 
+<!-- see https://github.com/quarto-dev/quarto-cli/discussions/4849#discussioncomment-11622517 -->
+In PDF output, if you want to specify table float placement (e.g., T for top), be sure to add both `tbl-pos="t"` and `layout-ncol="1"` in the div:
+
+````markdown
+::: {#tbl-rubric tbl-pos="t" layout-ncol="1"}
+
+| Criterion         | Meets Expectations (10) | Needs Improvement (5)  |
+|-------------------|-------------------------|------------------------|
+| **Understanding** | Clear understanding.    | Unclear understanding. |
+| **Completion**    | Task completed.         | Task incomplete.       |
+
+: Sample grading rubric
+
+:::
+
+````
+
 If the table is produced by an executable code cell, put the cell inside the div as content, e.g:
 
 ````markdown