(zettel (meta (back "00001007030000 00001007800000 00001012920513") (backward "00001007030000 00001007800000 00001012920513") (box-number "1") (created "20210126175322") (forward "00001007030500 00001007050000") (modified "20230807170858") (published "20230807170858") (role "manual") (syntax "zmk") (tags "#manual #zettelmarkup #zettelstore") (title "Zettelmarkup: Comment Blocks")) (rights 4) (encoding "") (content "Comment blocks are quite similar to [[verbatim blocks|00001007030500]]: both are used to enter text that should not be interpreted.\nWhile the text entered inside a verbatim block will be processed somehow, text inside a comment block will be ignored[^Well, not completely ignored: text is read, but it will typically not rendered visible.].\nComment blocks are typically used to give some internal comments, e.g. the license of a text or some internal remarks.\n\nComment blocks begin with at least three percent sign characters (\"\"''%''\"\", U+0025) at the first position of a line.\nYou can add some [[attributes|00001007050000]] on the beginning line of a comment block, following the initiating characters.\nThe comment block supports the default attribute: when given, the text will be rendered, e.g. as an HTML comment.\nWhen rendered to a symbolic expression, the comment block will not be ignored but it will output some text.\nSame for other renderer.\n\nAny other character in this line will be ignored\n\nText 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.\nThis allows to enter some percent sign characters in the text that should not be interpreted.\n\nFor example:\n```zmk\n%%%\nComment\n  Block\n%%%\n```\nwill be completely ignored, while\n```zmk\n%%%{-}\nWill be rendered\n%%%\n```\nwill be rendered as some kind of comment[^This cannot be shown here, because a HTML comment will not be rendered visible; it will be in the HTML text.]."))