(zettel (meta (back "00001007000000 00001007010000 00001007040324 00001007050000 00001007800000 00001007906000 00001007990000 00001012931000") (backward "00001007000000 00001007010000 00001007031200 00001007040324 00001007050000 00001007800000 00001007906000 00001007990000 00001012931000") (box-number "1") (created "20210126175322") (forward "00001007030100 00001007030200 00001007030300 00001007030400 00001007030500 00001007030600 00001007030700 00001007030800 00001007030900 00001007031000 00001007031100 00001007031200 00001007031300 00001007031400 00001007040000") (modified "20241212153023") (published "20241212153023") (role "manual") (syntax "zmk") (tags "#manual #zettelmarkup #zettelstore") (title "Zettelmarkup: Block-Structured Elements")) (rights 4) (encoding "") (content "Every markup for blocks-structured elements (\"\"blocks\"\") begins at the very first position of a line.\n\nThere are five kinds of blocks: lists, one-line blocks, line-range blocks, tables, and paragraphs.\n\n=== Lists\n\nIn Zettelmarkup, lists themselves are not specified, but list items.\nA sequence of list items is considered as a list.\n\n[[Description lists|00001007030100]] contain two different item types: the term to be described and the description itself.\nThese cannot be combined with other lists.\n\nOrdered lists, unordered lists, and quotation lists can be combined into [[nested lists|00001007030200]].\n\n=== One-line blocks\n\n* [[Headings|00001007030300]] allow to structure the content of a zettel.\n* The [[horizontal rule|00001007030400]] signals a thematic break\n* A [[transclusion|00001007031100]] embeds the content of one zettel into another.\n\n=== Line-range blocks\n\nThis kind of blocks encompass at least two lines.\nTo be useful, they encompass more lines.\nThey begin with at least three identical characters at the first position of the beginning line.\nThey end at the line, that contains at least the same number of these identical characters, beginning at the first position of that line.\nThis allows line-range blocks to be nested.\nAdditionally, all other blocks elements are allowed in line-range blocks.\n\n* [[Verbatim blocks|00001007030500]] do not interpret their content,\n* [[Quotation blocks|00001007030600]] specify a block-length quotations,\n* [[Verse blocks|00001007030700]] allow to enter poetry, lyrics and similar text, where line endings are important,\n* [[Region blocks|00001007030800]] just mark regions, e.g. for common formatting,\n* [[Comment blocks|00001007030900]] allow to enter text that will be ignored when rendered.\n* [[Evaluation blocks|00001007031300]] specify some content to be evaluated by either Zettelstore or external software.\n* [[Math-mode blocks|00001007031400]] can be used to enter mathematical formulas / equations.\n* [[Inline-Zettel blocks|00001007031200]] provide a mechanism to specify zettel content with a new syntax without creating a new zettel.\n\n=== Tables\n\nSimilar to lists are tables not specified explicitly.\nA sequence of table rows is considered a [[table|00001007031000]].\nA table row itself is a sequence of table cells.\n\n=== Paragraphs\n\nAny line that does not conform to another blocks-structured element begins a paragraph.\nThis has the implication that a mistyped syntax element for a block element will be part of the paragraph. For example:\n```zmk\n= Heading\nSome text follows.\n```\nwill be rendered in HTML as\n:::example\n= Heading\nSome text follows.\n:::\nThis is because headings need at least three equal sign character.\n\nA paragraph is essentially a sequence of [[inline-structured elements|00001007040000]].\nInline-structured elements can span more than one line.\nParagraphs are separated by empty lines.\n\nIf you want to specify a second paragraph inside a list item, or if you want to continue a paragraph on a second and more line within a list item, you must begin the paragraph with a certain number of space characters.\nThe number of space characters depends on the kind of a list and the relevant nesting level.\n\nA line that begins with a space character and which is outside of a list or does not contain the right number of space characters is considered to be part of a paragraph."))