Typst "Grid Customization" lists `body-width`, but it has no effect

What would you like to do?

Report an issue on quarto.org

Description

Page: https://quarto.org/docs/output-formats/typst.html#grid-customization

The Typst Grid Customization section documents three grid options:

…and the example sets all three:

format:
  typst:
    grid:
      margin-width: 2in
      body-width: 4in
      gutter-width: 0.25in

However, body-width is silently ignored. Quarto's geometry calculation reads it but never uses it.
For reference, the mapping lives in typstGeometryFromPaperWidth — margin-width/gutter-width are consumed but body-width is not:

https://github.com/quarto-dev/quarto-cli/blob/e768e5c2d34381173aa3d43d8d3a332125647561/src/resources/filters/layout/meta.lua#L479-L496

If we view this as a docs issue, I think the solution is:

1. Drop body-width from the Typst grid table. Remove it from the example.
2. Clarify the two that work:
   • margin-width — width of the margin note column.
   • gutter-width — gap between the body and the margin column.
3. Note that the body width is whatever space is left over and point to margin-geometry for full control.

However, we could potentially honor body-width if zero or one of margin-width and gutter-width is supplied, and warn if all three are supplied. @gordonwoodhull, if you think that's a better fix, feel free to relabel.

Start at the Typst grid customization page linked in the issue and inspect the documented options and example. Check src/resources/filters/layout/meta.lua at typstGeometryFromPaperWidth to confirm the current behavior; done means the page documents only the supported settings, explains the remaining body width, and points to margin-geometry.