Docs

Paragraph

Learn how to style and format paragraphs in your documents.

AI assisted, human approved — novem uses AI to review and keep our documentation up to date.

{{ paragraph
  font size: l
  font style: b
  font align: center
  fg: blue-700
}}

Styled markdown text

{{ /paragraph }}

The paragraph section is a wrapper that applies styling across several markdown elements. It supports font size, style and alignment in addition to the common parameters for spacing, borders and colours.

The font-style, spacing and colour controls match the mail paragraph section. The positioning options below — align, width and height — are doc-specific and let a paragraph behave as a sized, aligned block on the page.

keyword: font size / sz
options: xs | s | m | l | xl | xxl | xxxl


keyword: font style / st
options: s | strong | b | bold | i | italic | regular | r

Styles can be combined with a space, e.g. b i for bold italic.

keyword: font align / al
options: l | left | r | right | c | center | j | justify


keyword: align
options: < | > | - | ^ | v  (combine up to two, e.g. -^, >v)

Box-level alignment for the paragraph's content using the same single-character grammar as matrix tables. <, - and > are the horizontal axis (left, center, right); ^ and v are the vertical axis (top, bottom; middle is the default). Symbols can be combined, e.g. -^ for centered horizontally and pinned to the top, >v for right-aligned at the bottom.

Setting align switches the paragraph to a flex column so children can be positioned on both axes — vertical positioning only has a visible effect when the paragraph also has a height (see height below). The horizontal symbol additionally sets text-align so inline text inside child paragraphs follows the same direction.

keyword: width
options: any CSS length, e.g. 80%, 240px, 30rem

Sets an explicit width on the paragraph box. The value is passed through to CSS verbatim, so anything width: accepts is valid.

keyword: height
options: any CSS length, or 100%

Sets an explicit height on the paragraph box. Use height: 100% to opt the paragraph into the same leftover-space pass that fills {{ vis }} blocks marked with height: 100%: the layout engine measures every other element on the page first and assigns the flex paragraphs the remaining vertical space. This is what makes full-bleed callouts or hero blocks work on a fixed-orientation page.

{{ para
  sz: xxl
  st: b
  al: center
  fg: blue-800
  m: t4 b2
}}
# Document Title
{{ /para }}


{{ para
  sz: s
  st: i
  fg: gray-600
  b: l2 gray-400
  p: l2
}}
This document is for informational purposes only and should not
be used for investment decisions.
{{ /para }}


{{ para
  b: l3 blue-500
  p: l2
  m: b2
}}
**Finding 1:** The flexicurity model is increasingly a Danish
phenomenon rather than a Nordic one.
{{ /para }}


{{ para
  width: 100%
  height: 100%
  align: -
  sz: xxxl
  st: b
  fg: blue-800
}}
A bold statement, centered on a page of its own.
{{ /para }}

The height: 100% opts the paragraph into the leftover-space pass so it expands to fill whatever vertical room the rest of the page leaves unused; align: - centers the content on both axes within that box.

Next
Callouts