((META (EMPTY-STRING title "Zettelmarkup: Headings") (WORD role "manual") (TAG-SET tags ("#manual" "#zettelmarkup" "#zettelstore")) (WORD syntax "zmk") (ZID-SET back ("00001007010000" "00001007030000" "00001007040324" "00001007721200" "00001007800000" "00001007906000" "00001007990000")) (ZID-SET backward ("00001007010000" "00001007030000" "00001007040324" "00001007721200" "00001007800000" "00001007906000" "00001007990000")) (NUMBER box-number "1") (STRING copyright "(c) 2020-present by Detlef Stern <ds@zettelstore.de>") (TIMESTAMP created "20210126175322") (ZID-SET forward ("00001007040000")) (WORD lang "en") (EMPTY-STRING license "EUPL-1.2-or-later") (TIMESTAMP modified "20220218133755") (TIMESTAMP published "20220218133755") (WORD visibility "public")) (BLOCK (PARA (TEXT "To specify a (sub-) section of a zettel, you should use the headings syntax: at") (SOFT) (TEXT "the beginning of a new line type at least three equal signs (") (FORMAT-QUOTE () (LITERAL-INPUT () "=")) (TEXT ", U+003D), plus at least one") (SOFT) (TEXT "space and enter the text of the heading as ") (LINK-ZETTEL () "00001007040000" (TEXT "inline elements")) (TEXT ".")) (VERBATIM-CODE (("" . "zmk")) "=== Level 1 Heading\n==== Level 2 Heading\n===== Level 3 Heading\n====== Level 4 Heading\n======= Level 5 Heading\n======== Level 5 Heading") (PARA (TEXT "This renders in HTML as:")) (REGION-BLOCK (("" . "example")) ((HEADING 1 () "level-1-heading" "level-1-heading" (TEXT "Level 1 Heading")) (HEADING 2 () "level-2-heading" "level-2-heading" (TEXT "Level 2 Heading")) (HEADING 3 () "level-3-heading" "level-3-heading" (TEXT "Level 3 Heading")) (HEADING 4 () "level-4-heading" "level-4-heading" (TEXT "Level 4 Heading")) (HEADING 5 () "level-5-heading" "level-5-heading" (TEXT "Level 5 Heading")) (HEADING 5 () "level-5-heading" "level-5-heading-1" (TEXT "Level 5 Heading")))) (HEADING 1 () "notes" "notes" (TEXT "Notes")) (PARA (TEXT "The heading level is translated to a HTML heading by adding 1 to the level, e.g. ") (LITERAL-CODE (("" . "zmk")) "=== Level 1 Heading") (TEXT " translates to ") (LITERAL-OUTPUT (("" . "html")) "<h2>Level 1 Heading</h2>") (TEXT ".") (SOFT) (TEXT "The ") (LITERAL-OUTPUT (("" . "html")) "<h1>") (TEXT " tag is rendered for the zettel title.")) (PARA (TEXT "This syntax is often used in a similar way in wiki implementation.") (SOFT) (TEXT "However, trailing equal signs are ") (FORMAT-EMPH () (TEXT "not")) (TEXT " removed, they are part of the heading text.")) (PARA (TEXT "If you use command line tools, you can easily create a draft table of contents with the command:")) (VERBATIM-CODE (("" . "sh")) "grep -h '^====* ' ZETTEL_ID.zettel")))