((p "Region blocks does not directly have a visual representation." " " "They just group a range of lines." " " "You can use region blocks to enter " (a (@ (href . "00001007050000")) "attributes") " that apply only to this range of lines." " " "One example is to enter a multi-line warning that should be visible.") (p "This kind of line-range block begins with at least three colon characters (" (@L (@H "“") (kbd ":") (@H "”")) ", U+003A) at the first position of a line" (sup (@ (id . "fnref:1")) (a (@ (class . "zs-noteref") (href . "#fn:1") (role . "doc-noteref")) "1")) "." " " "You can add some " (a (@ (href . "00001007050000")) "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 " (code "=note") ", " (code "=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.") (p "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 " (a (@ (href . "00001007040000")) "inline elements") " after the colon characters." " " "These will interpreted as some attribution text.") (p "For example:") (pre (code (@ (class . "language-zmk")) "::::{style=color:green}\nA region block with\n an embedded region block\n:::{style=color:black}\nEmbedded\n region\nblock\n::: Embedded Author\n:::: Region Author")) (p "will be rendered in HTML as:") (div (@ (class . "example")) (div (@ (style . "color:green")) (p "A region block with" " " " an embedded region block") (div (@ (style . "color:black")) (p "Embedded" " " " region" " " "block") (cite "Embedded Author")) (cite "Region Author"))) (p "An example for a warning region block:") (pre (code (@ (class . "language-zmk")) ":::warning\nDo not copy from the Internet, know your sponsors.\n:::")) (p "will be rendered as:") (div (@ (class . "example")) (div (@ (class . "warning")) (p "Do not copy from the Internet, know your sponsors."))) (p "Generic attributes that are result in a special HTML rendering are:") (ul (li "example") (li "note") (li "tip") (li "important") (li "caution") (li "warning")) (p "All other generic attribute values are rendered as a CSS class:") (pre (code (@ (class . "language-zmk")) ":::abc\ndef\n:::")) (p "is rendered as") (div (@ (class . "example")) (div (@ (class . "abc")) (p "def"))))