(((meta (@ (content . "Zettelmarkup: Tables") (name . "title"))) (meta (@ (content . "manual") (name . "role"))) (meta (@ (content . "#manual #zettelmarkup #zettelstore") (name . "tags"))) (meta (@ (content . "zmk") (name . "syntax"))) (meta (@ (content . "00001007010000 00001007030000 00001007800000 00001007990000 00001012920513") (name . "back"))) (meta (@ (content . "00001007010000 00001007030000 00001007800000 00001007990000 00001012920513") (name . "backward"))) (meta (@ (content . "1") (name . "box-number"))) (meta (@ (content . "(c) 2020-present by Detlef Stern <ds@zettelstore.de>") (name . "copyright"))) (meta (@ (content . "20210126175322") (name . "created"))) (meta (@ (content . "00001004100000 00001007040000") (name . "forward"))) (meta (@ (content . "en") (name . "lang"))) (meta (@ (content . "EUPL-1.2-or-later") (name . "license"))) (meta (@ (content . "20241212153641") (name . "modified"))) (meta (@ (content . "20241212153641") (name . "published"))) (meta (@ (content . "public") (name . "visibility")))) (p "Tables are used to show some data in a two-dimensional fashion." " " "In zettelmarkup, tables are not specified explicitly, but by entering " (em "table rows") "." " " "Therefore, a table can be seen as a sequence of table rows." " " "A table row is nothing but a sequence of " (em "table cells") "." " " "The length of a table is the number of table rows, the width of a table is the maximum length of its rows.") (p "The first cell of a row must begin with the vertical bar character (" (@L (@H "&ldquo;") (kbd "|") (@H "&rdquo;")) ", U+007C) at the first position of a line." " " "The other cells of a row begin with the same vertical bar character at later positions in that line." " " "A cell is delimited by the vertical bar character of the next cell or by the end of the current line." " " "A vertical bar character as the last character of a line will not result in a table cell." " " "It will be ignored." " " "Inside a cell, you can specify any " (a (@ (href . "00001007040000")) "inline elements") ".") (p "For example:") (pre (code (@ (class . "language-zmk")) "| a1 | a2 | a3|\n| b1 | b2 | b3\n| c1 | c2")) (p "will be rendered in HTML as:") (div (@ (class . "example")) (table (tbody (tr (td "a1") (td "a2") (td "a3")) (tr (td "b1") (td "b2") (td "b3")) (tr (td "c1") (td "c2") (td))))) (h2 (@ (id . "header-row")) "Header row") (p "If any cell in the first row of a table contains an equal sing character (" (@L (@H "&ldquo;") (kbd "=") (@H "&rdquo;")) ", U+003D) as the very first character, then this first row will be interpreted as a " (em "table header") " row.") (p "For example:") (pre (code (@ (class . "language-zmk")) "| a1 | a2 |= a3|\n| b1 | b2 | b3\n| c1 | c2")) (p "will be rendered in HTML as:") (div (@ (class . "example")) (table (thead (tr (th "a1") (th "a2") (th "a3"))) (tbody (tr (td "b1") (td "b2") (td "b3")) (tr (td "c1") (td "c2") (td))))) (h2 (@ (id . "column-alignment")) "Column alignment") (p "Inside a header row, you can specify the alignment of each header cell by a given character as the last character of a cell." " " "The alignment of a header cell determines the alignment of every cell in the same column." " " "The following characters specify the alignment:") (ul (li "the colon character (" (@L (@H "&ldquo;") (kbd ":") (@H "&rdquo;")) ", U+003A) forces a centered alignment,") (li "the less-than sign character (" (@L (@H "&ldquo;") (kbd "<") (@H "&rdquo;")) ", U+0060) specifies an alignment to the left,") (li "the greater-than sign character (" (@L (@H "&ldquo;") (kbd ">") (@H "&rdquo;")) ", U+0062) will produce right aligned cells.")) (p "If no alignment character is given, a default alignment is used.") (p "For example:") (pre (code (@ (class . "language-zmk")) "|=Left<|Right>|Center:|Default\n|123456|123456|123456|123456|\n|123|123|123|123")) (p "will be rendered in HTML as:") (div (@ (class . "example")) (table (thead (tr (th (@ (class . "left")) "Left") (th (@ (class . "right")) "Right") (th (@ (class . "center")) "Center") (th "Default"))) (tbody (tr (td (@ (class . "left")) "123456") (td (@ (class . "right")) "123456") (td (@ (class . "center")) "123456") (td "123456")) (tr (td (@ (class . "left")) "123") (td (@ (class . "right")) "123") (td (@ (class . "center")) "123") (td "123"))))) (h2 (@ (id . "cell-alignment")) "Cell alignment") (p "To specify the alignment of an individual cell, you can enter these characters for alignment as the first character of that cell.") (p "For example:") (pre (code (@ (class . "language-zmk")) "|=Left<|Right>|Center:|Default\n|>R|:C|<L\n|123456|123456|123456|123456|\n|123|123|123|123")) (p "will be rendered in HTML as:") (div (@ (class . "example")) (table (thead (tr (th (@ (class . "left")) "Left") (th (@ (class . "right")) "Right") (th (@ (class . "center")) "Center") (th "Default"))) (tbody (tr (td (@ (class . "right")) "R") (td (@ (class . "center")) "C") (td (@ (class . "left")) "L") (td)) (tr (td (@ (class . "left")) "123456") (td (@ (class . "right")) "123456") (td (@ (class . "center")) "123456") (td "123456")) (tr (td (@ (class . "left")) "123") (td (@ (class . "right")) "123") (td (@ (class . "center")) "123") (td "123"))))) (h2 (@ (id . "rows-to-be-ignored")) "Rows to be ignored") (p "A line that begins with the sequence " (kbd "|%") " (vertical bar character (" (@L (@H "&ldquo;") (kbd "|") (@H "&rdquo;")) ", U+007C), followed by a percent sign character (“%”, U+0025)) will be ignored." " " "For example, this allows to specify a horizontal rule that is not rendered." " " "Such tables are emitted by some commands of the " (a (@ (href . "00001004100000")) "administrator console") "." " " "For example, the command " (code "get-config box") " will emit:") (pre (code "|=Key        | Value  | Description\n|%-----------+--------+---------------------------\n| defdirtype | notify | Default directory box type")) (p "This is rendered in HTML as:") (div (@ (class . "example")) (table (thead (tr (th "Key") (th "Value") (th "Description"))) (tbody (tr (td "defdirtype") (td "notify") (td "Default directory box type"))))))