((p "Comment blocks are quite similar to " (a (@ (href . "00001007030500")) "verbatim blocks") ": both are used to enter text that should not be interpreted." " " "While the text entered inside a verbatim block will be processed somehow, text inside a comment block will be ignored" (sup (@ (id . "fnref:1")) (a (@ (class . "zs-noteref") (href . "#fn:1") (role . "doc-noteref")) "1")) "." " " "Comment blocks are typically used to give some internal comments, e.g. the license of a text or some internal remarks.") (p "Comment blocks begin with at least three percent sign characters (" (@L (@H "“") (kbd "%") (@H "”")) ", U+0025) at the first position of a line." " " "You can add some " (a (@ (href . "00001007050000")) "attributes") " on the beginning line of a comment block, following the initiating characters." " " "The comment block supports the default attribute: when given, the text will be rendered, e.g. as an HTML comment." " " "When rendered to a symbolic expression, the comment block will not be ignored but it will output some text." " " "Same for other renderer.") (p "Any other character in this line will be ignored") (p "Text following the beginning line will not 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 some percent sign characters in the text that should not be interpreted.") (p "For example:") (pre (code (@ (class . "language-zmk")) "%%%\nComment\n  Block\n%%%")) (p "will be completely ignored, while") (pre (code (@ (class . "language-zmk")) "%%%{-}\nWill be rendered\n%%%")) (p "will be rendered as some kind of comment" (sup (@ (id . "fnref:2")) (a (@ (class . "zs-noteref") (href . "#fn:2") (role . "doc-noteref")) "2")) "."))