title: Zettelmarkup: Region Blocks
role: manual
tags: #manual #zettelmarkup #zettelstore
syntax: zmk
back: 00001007030000 00001007031110 00001007040100 00001007800000 00001012920513
backward: 00001007030000 00001007031110 00001007040100 00001007800000 00001012920513
box-number: 1
copyright: (c) 2020-present by Detlef Stern <ds@zettelstore.de>
created: 20210126175322
forward: 00001007030100 00001007040000 00001007050000
lang: en
license: EUPL-1.2-or-later
modified: 20251218184240
published: 20251218184240
visibility: public

Region blocks do not directly have a visual representation.
They just group a range of lines.
You can use region blocks to enter [attributes](00001007050000) 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 (&ldquo;`:`&rdquo;, U+003A) at the first position of a line.
You can add some [attributes](00001007050000) 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](00001007040000) after the colon characters.
These will be 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:



An example for a warning region block:

    :::warning
    Do not copy from the Internet, know your sponsors.
    :::

will be rendered as:



Generic attributes that 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