Skip to content

1.9/ungrid tables #1807

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: prerelease
Choose a base branch
from
Open

1.9/ungrid tables #1807

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
ae08e02
use list-tables instead of grid tables
cscheid Oct 9, 2025
75ef592
merge
cscheid Oct 10, 2025
7c6b4b2
list table fixes for pandoc 3.6 misparses
cscheid Oct 10, 2025
a5a956e
more list-table fixes for pandoc 3.6 misparses
cscheid Oct 10, 2025
daef34b
additional fixes from automated conversion
cscheid Oct 11, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
123 changes: 73 additions & 50 deletions docs/advanced/environment-vars.qmd
View file
Open in desktop

Large diffs are not rendered by default.

219 changes: 156 additions & 63 deletions docs/authoring/article-layout.qmd
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -345,24 +345,32 @@ reference-location: margin

All of the below options currently only support setting a value of `margin` which tells Quarto to place the corresponding element in the margin.

+----------------------+---------------------------------------------------------------------------------------------------------+
| Option | Description |
+======================+=========================================================================================================+
| `reference-location` | Where to place footnotes. Defaults to `document`.\ |
| | \[`document` \| `section` \| `block` \| `margin` \] |
+----------------------+---------------------------------------------------------------------------------------------------------+
| `citation-location` | Where to place citations. Defaults to `document`.\ |
| | \[`document` \| `margin` \] |
+----------------------+---------------------------------------------------------------------------------------------------------+
| `cap-location` | Where to place figure and table captions. Defaults to `bottom` for figures and `top` for tables.\ |
| | \[`top` \| `bottom` \| `margin`\] |
+----------------------+---------------------------------------------------------------------------------------------------------+
| `fig-cap-location` | Where to place figure captions. Defaults to `bottom`.\ |
| | \[`top` \| `bottom` \| `margin`\] |
+----------------------+---------------------------------------------------------------------------------------------------------+
| `tbl-cap-location` | Where to place table captions. Defaults to `top`.\ |
| | \[`top` \| `bottom` \| `margin`\] |
+----------------------+---------------------------------------------------------------------------------------------------------+
::: {.list-table header-rows="1" widths="0.17829457364341,0.82170542635659"}

* * Option
* Description

* * `reference-location`
* Where to place footnotes. Defaults to `document`.\
[`document` | `section` | `block` | `margin` ]

* * `citation-location`
* Where to place citations. Defaults to `document`.\
[`document` | `margin` ]

* * `cap-location`
* Where to place figure and table captions. Defaults to `bottom` for figures and `top` for tables.\
[`top` | `bottom` | `margin`]

* * `fig-cap-location`
* Where to place figure captions. Defaults to `bottom`.\
[`top` | `bottom` | `margin`]

* * `tbl-cap-location`
* Where to place table captions. Defaults to `top`.\
[`top` | `bottom` | `margin`]

:::

### Code Cell Options

Expand All @@ -375,24 +383,33 @@ plot(cars)
```

::: column-page-right
+--------------------+------------------------------------------------------------------------------------------------------------------------------+
| Option | Description |
+====================+==============================================================================================================================+
| `column` | Layout column to use for code cell outputs. See column options below. |
+--------------------+------------------------------------------------------------------------------------------------------------------------------+
| `fig-column` | Layout column to use for code cell figure outputs. See column options below. |
+--------------------+------------------------------------------------------------------------------------------------------------------------------+
| `tbl-column` | Layout column to use for code cell table outputs. See column options below. |
+--------------------+------------------------------------------------------------------------------------------------------------------------------+
| `cap-location` | Where to place figure and table captions produced by this code cell. Defaults to `bottom` for figures and `top` for tables.\ |
| | \[`top` \| `bottom` \| `margin`\] |
+--------------------+------------------------------------------------------------------------------------------------------------------------------+
| `fig-cap-location` | Where to place captions for figures produced by this code cell. Defaults to `inline`.\ |
| | \[`inline` \| `margin`\] |
+--------------------+------------------------------------------------------------------------------------------------------------------------------+
| `tbl-cap-location` | Where to place captions for tables produced by this code cell. Defaults to `inline`.\ |
| | \[`inline` \| `margin`\] |
+--------------------+------------------------------------------------------------------------------------------------------------------------------+
::: {.list-table header-rows="1" widths="0.14189189189189,0.85810810810811"}

* * Option
* Description

* * `column`
* Layout column to use for code cell outputs. See column options below.

* * `fig-column`
* Layout column to use for code cell figure outputs. See column options below.

* * `tbl-column`
* Layout column to use for code cell table outputs. See column options below.

* * `cap-location`
* Where to place figure and table captions produced by this code cell. Defaults to `bottom` for figures and `top` for tables.\
[`top` | `bottom` | `margin`]

* * `fig-cap-location`
* Where to place captions for figures produced by this code cell. Defaults to `inline`.\
[`inline` | `margin`]

* * `tbl-cap-location`
* Where to place captions for tables produced by this code cell. Defaults to `inline`.\
[`inline` | `margin`]

:::
:::

### Using Classes
Expand All @@ -410,33 +427,109 @@ This content will appear in the margin!
Here are all of the available column specifiers:

::: column-page-right
+--------------+---------------------------------+---------------------------------+
| Column | Code Cell `column` | Class Name |
+==============+=================================+=================================+
| Body | column: body | .column-body |
| | column: body-outset | .column-body-outset |
| | column: body-outset-left | .column-body-outset-left |
| | column: body-outset-right | .column-body-outset-right |
+--------------+---------------------------------+---------------------------------+
| Page Inset | column: page-inset | .column-page-inset |
| | column: page-inset-left | .column-page-inset-left |
| | column: page-inset-right | .column-page-inset-right |
+--------------+---------------------------------+---------------------------------+
| Page | column: page | .column-page |
| | column: page-left | .column-page-left |
| | column: page-right | .column-page-right |
+--------------+---------------------------------+---------------------------------+
| Screen Inset | column: screen-inset | .column-screen-inset |
| | column: screen-inset-shaded | .column-screen-inset-shaded |
| | column: screen-inset-left | .column-screen-inset-left |
| | column: screen-inset-right | .column-screen-inset-right |
+--------------+---------------------------------+---------------------------------+
| Screen | column: screen | .column-screen |
| | column: screen-left | .column-screen-left |
| | column: screen-right | .column-screen-right |
+--------------+---------------------------------+---------------------------------+
| Margin | column: margin | .column-margin |
+--------------+---------------------------------+---------------------------------+
::: {.list-table header-rows="1" widths="0.2,0.4,0.4"}

* * Column
* Code Cell `column`
* Class Name

* * Body

*
```
column: body
column: body-outset
column: body-outset-left
column: body-outset-right
```

*
```
.column-body
.column-body-outset
.column-body-outset-left
.column-body-outset-right
```

* * Page Inset

*
```
column: page-inset
column: page-inset-left
column: page-inset-right
```

*
```
.column-page-inset
.column-page-inset-left
.column-page-inset-right
```

* * Page

*
```
column: page
column: page-left
column: page-right
```

*
```
.column-page
.column-page-left
.column-page-right
```

* * Screen Inset

*
```
column: screen-inset
column: screen-inset-shaded
column: screen-inset-left
column: screen-inset-right
```

*
```
.column-screen-inset
.column-screen-inset-shaded
.column-screen-inset-left
.column-screen-inset-right
```

* * Screen

*
```
column: screen
column: screen-left
column: screen-right
```

*
```
.column-screen
.column-screen-left
.column-screen-right
```

* * Margin

*
```
column: margin
```

*
```
.column-margin
```

:::
:::

## PDF/LaTeX Layout {data-link="PDF/LaTeX Layout"}
Expand Down
Loading