RenderBlockContent

A block content element.

enum RenderBlockContent

Discussion

Block elements introduce a break in their container’s layout flow, and usually represent a discrete item of their parent’s content.

Historically, the name “block element” comes from rendering scrollable, vertical content. A block element introduced a break in the horizontal flow, was preceded with an empty new line, and took the whole width, which started a new horizontal flow. These are headings, paragraphs, tables, and more.

[ Paragraph ...    ]
- - - - - - - - - -
[ Aside Note ...   ]
- - - - - - - - - -
[ Code Listing ... ]
- - - - - - - - - - 
[ Paragraph ...    ]

RenderBlockContent contains traditional elements like RenderBlockContent.paragraph(_:) and RenderBlockContent.heading(_:) but also other documentation-specific elements like RenderBlockContent.step(_:) and RenderBlockContent.endpointExample(_:).

Block elements can be nested, for example, an aside note contains one or more paragraphs of text.