Zettelmarkup: Region Blocks
Region blocks does not directly have a visual representation. They just group a range of lines. You can use region blocks to enter attributes that apply only to this range of lines. One example is to enter a multi-line warning that should be visible.
This kind of line-range block begins with at least three colon characters (“:”, U+003A) at the first position of a line1. You can add some attributes on the beginning line of a region block, following the initiating characters. The region block does not support the default attribute, but it supports the generic attribute. Some generic attributes, like =note
, =warning
will be rendered special. All other generic attributes are used as a CSS class definition. Attributes are interpreted on HTML rendering. Any other character in this line will be ignored.
Text following the beginning line will be interpreted, until a line begins with at least the same number of the same characters given at the beginning line. This allows to enter a region block within a region block. At the ending line, you can enter some inline elements after the colon characters. These will interpreted as some attribution text.
For example:
::::{style=color:green}
A region block with
an embedded region block
:::{style=color:black}
Embedded
region
block
::: Embedded Author
:::: Region Author
will be rendered in HTML as:
A region block with an embedded region block
Embedded region block
Embedded AuthorAn example for a warning region block:
:::warning
Do not copy from the Internet, know your sponsors.
:::
will be rendered as:
Do not copy from the Internet, know your sponsors.
Generic attributes that are result in a special HTML rendering are:
- example
- note
- tip
- important
- caution
- warning
All other generic attribute values are rendered as a CSS class:
:::abc
def
:::
is rendered as
def
- Since a description text only use exactly one colon character at the first position of a line, there is no possible ambiguity between these elements. ↩︎