Layouts for blocks

[andrewpbray]

While reading through the docs at Guide >> Authoring >> Figures, I came across the different layout attributes that can be specified. At the end of the section, it mentions that these layouts work for any block element - that's great.

That made me turn to the reference section to find the list of all of the different layouts and their options / specs. The only one I could find was in Code Cells > knitr > Panel Layout. In that section there is mention of layout-align. I tried using this on a block element but it didn't quite work.

---
format: pdf
---

:::{layout-ncol=2 layout-align=left}

- 1
- 2
- 3

this is left aligned
:::

:::{layout-ncol=2 layout-align=center}

- 1
- 2
- 3

this is centered
:::


:::{layout-ncol=2 layout-align=right}

- 1
- 2
- 3

this is right aligned
:::

Is this is a bug/oversight or is layout-align just meant to be a cell attribute? Would it make sense to make a separate reference section for the layouts that work on block elements?

[mcanouil]

If I am not mistaken those layout options are for knitr cell outputs not div blocks as in your example.

Multiple columns are described in the following page (and some other places, you can search in the website for "multiple columns"): https://quarto.org/docs/presentations/index.html#multiple-columns