Skip to main content
The Brief block lays out a sheet in two columns: a short heading on the left, its details on the right. Use it for method statements, technical memos and fact sheets, instead of a two-column table.
To add this block, on an empty line of the document (not inside another block), type /brief then select Brief.

Rows

A brief is made of rows, each with a heading and its content.
  • A section row opens a part of the brief; a brief always starts with one. A line in the document’s colour runs over the heading and another over the content, and its first paragraph reads as the part’s title.
  • A detail row details the section above it. Its heading is grey, and a dashed line separates it from the previous detail.
  • A detail row with no heading reads as one item of a list: use it for a series of points, each with a bold title and a short description.
The right column holds what a column holds: text, lists, checklists, tables, images, callouts. Type / there to add a block.

Editing

  • Press Enter or Tab in a heading to go to its content. In an entirely empty row, Enter takes the next step described below instead, while Tab still goes to the content. From a paragraph of the content, Shift + Tab brings you back to the heading; in a list, it outdents the item.
  • At the end of a text, each press of Enter goes one step further: a new line, then a new detail row, then that empty row becomes a section, then it goes: you leave the brief if it was the last row, otherwise you go on to the next row. A row with text is never changed by Enter.
  • Press Backspace in an empty row to remove it.
  • Hover a row and click its handle to switch it between section and detail, insert a row above or below, comment, duplicate or delete it. Drag the handle to move the row, within the brief or to another one.
  • Hover the brief and click + under its last row to add a section.
  • In the block menu of the brief, Label column colour fills that column; the default colour takes it away.
Several briefs can follow each other: add a new Brief block for each sheet.

Appearance

Headings are in small capitals: in the document’s primary colour for sections, in grey for details. Select a heading’s text to make it bold or italic, change its colour or alignment. You can fill the heading column with a light shade of a colour, or with the solid primary or secondary colour of the document: the headings then turn black or white, whichever reads best. In the PDF, a row is never split across two pages when it fits on one, and spacing is tighter. On a narrow screen, each heading goes above its content.