Table and Grid Formatting

typstyle applies intelligent formatting to tables and grids based on content structure:

• General Rules

  • headerheader, footerfooter, and line comments (////) always occupy their own lines.
  • Block comments disable table formatting entirely.
  • Blank lines are preserved and prevent reflow across them.

• Header & Footer

  • Both follow the table’s defined column layout.

• Cell Reflow

  • Reflow applies only when no special cells are present. Special cells include:

    • cellcell
    • hlinehline
    • vlinevline
    • Spread args (....)
  • If no special cells exist, typstyle reflows all cells to fit the columns.
  • Otherwise, the original grid structure is preserved.

typstyle formats tables and grids in a “column-aware” way, recognizing basic patterns and column numbers. Single rows are kept on single lines when possible:

1
#table(
2
  columns: (auto, 1fr,) + (auto,),
3
  [Ethanol], [78.2], [241.0],   [Methanol],
4
   [64.7], [239.5],
5
  [Propanol], [97.4], [263.7], table.footer(
6
  repeat: true,     [Alcohols], [Average], [>240°C]
7
  )
8
)

1
#table(
2
  columns: (auto, 1fr,) + (auto,),
3
  [Ethanol], [78.2], [241.0],   [Methanol],
4
   [64.7], [239.5],
5
  [Propanol], [97.4], [263.7], table.footer(
6
  repeat: true,     [Alcohols], [Average], [>240°C]
7
  )
8
)

1
#table(
2
  columns: (auto, 1fr) + (auto,),
3
  [Ethanol], [78.2], [241.0],
4
  [Methanol], [64.7], [239.5],
5
  [Propanol], [97.4], [263.7],
6
  table.footer(
7
    repeat: true,
8
    [Alcohols], [Average], [>240°C],
9
  ),
10
)
11

1
#table(
2
  columns: (auto, 1fr) + (auto,),
3
  [Ethanol], [78.2], [241.0],
4
  [Methanol], [64.7], [239.5],
5
  [Propanol], [97.4], [263.7],
6
  table.footer(
7
    repeat: true,
8
    [Alcohols], [Average], [>240°C],
9
  ),
10
)
11

When a table row cannot fit on a single line, each cell is placed on its own line:

1
#figure(
2
  grid(
3
    columns: (auto,auto),
4
    rows: (auto,auto),
5
    gutter: 0em,
6
    [#image("assets/1.png",width: 59%)],[#image("assets/2.png", width: 55%)],
7
    [#image("assets/3.png",width: 1fr)],[#image("assets/4.png", width: 2fr)],
8
9
  ),
10
  caption: [],
11
)

1
#figure(
2
  grid(
3
    columns: (auto,auto),
4
    rows: (auto,auto),
5
    gutter: 0em,
6
    [#image("assets/1.png",width: 59%)],[#image("assets/2.png", width: 55%)],
7
    [#image("assets/3.png",width: 1fr)],[#image("assets/4.png", width: 2fr)],
8
9
  ),
10
  caption: [],
11
)

1
#figure(
2
  grid(
3
    columns: (auto, auto),
4
    rows: (auto, auto),
5
    gutter: 0em,
6
    [#image("assets/1.png", width: 59%)],
7
    [#image("assets/2.png", width: 55%)],
8
9
    [#image("assets/3.png", width: 1fr)],
10
    [#image("assets/4.png", width: 2fr)],
11
  ),
12
  caption: [],
13
)
14

1
#figure(
2
  grid(
3
    columns: (auto, auto),
4
    rows: (auto, auto),
5
    gutter: 0em,
6
    [#image("assets/1.png", width: 59%)],
7
    [#image("assets/2.png", width: 55%)],
8
9
    [#image("assets/3.png", width: 1fr)],
10
    [#image("assets/4.png", width: 2fr)],
11
  ),
12
  caption: [],
13
)
14

typstyle provides comprehensive support for complex table structures:

• Headers and footers are formatted as tables
• Special elements (cellcell, hlinehline, vlinevline) are recognized without prefixes
• Column count calculation handles complex expressions like ((1fr,) * 2 + 2 * (auto,)) * 3((1fr,) * 2 + 2 * (auto,)) * 3
• Headers, footers, and table cells with rowspan/colspan are properly handled

1
#table(
2
  columns: 7,
3
  rows: (2.5em,) * 3,
4
  align: horizon + center,
5
  table.cell(rowspan: 2)[],table.cell(colspan: 2)[Header 1],table.cell(colspan: 2)[Header 2],table.cell(colspan: 2)[Header 3],
6
  ..([Data],[Info]) * 3,
7
  $-2$,$20degree 9'$,$577.48$,$20degree 17'$,$581.14$,$15degree 5'$,$436.24$,
8
  $-1$,$9degree 54'$,$576.44$,$9degree 57'$,$579.32$,$7degree 29'$,$436.66$,
9
)

1
#table(
2
  columns: 7,
3
  rows: (2.5em,) * 3,
4
  align: horizon + center,
5
  table.cell(rowspan: 2)[],table.cell(colspan: 2)[Header 1],table.cell(colspan: 2)[Header 2],table.cell(colspan: 2)[Header 3],
6
  ..([Data],[Info]) * 3,
7
  $-2$,$20degree 9'$,$577.48$,$20degree 17'$,$581.14$,$15degree 5'$,$436.24$,
8
  $-1$,$9degree 54'$,$576.44$,$9degree 57'$,$579.32$,$7degree 29'$,$436.66$,
9
)

1
#table(
2
  columns: 7,
3
  rows: (2.5em,) * 3,
4
  align: horizon + center,
5
  table.cell(rowspan: 2)[],
6
  table.cell(colspan: 2)[Header 1],
7
  table.cell(colspan: 2)[Header 2],
8
  table.cell(colspan: 2)[Header 3],
9
  ..([Data], [Info]) * 3,
10
  $-2$, $20degree 9'$, $577.48$, $20degree 17'$, $581.14$, $15degree 5'$, $436.24$,
11
  $-1$, $9degree 54'$, $576.44$, $9degree 57'$, $579.32$, $7degree 29'$, $436.66$,
12
)
13

1
#table(
2
  columns: 7,
3
  rows: (2.5em,) * 3,
4
  align: horizon + center,
5
  table.cell(rowspan: 2)[],
6
  table.cell(colspan: 2)[Header 1],
7
  table.cell(colspan: 2)[Header 2],
8
  table.cell(colspan: 2)[Header 3],
9
  ..([Data], [Info]) * 3,
10
  $-2$, $20degree 9'$, $577.48$, $20degree 17'$, $581.14$, $15degree 5'$, $436.24$,
11
  $-1$, $9degree 54'$, $576.44$, $9degree 57'$, $579.32$, $7degree 29'$, $436.66$,
12
)
13