((META (EMPTY-STRING title "Zettelmarkup: Mark") (WORD role "manual") (TAG-SET tags ("#manual" "#zettelmarkup" "#zettelstore")) (WORD syntax "zmk") (ZID-SET back ("00001007030200" "00001007040300")) (ZID-SET backward ("00001007030200" "00001007040300" "00001007040324")) (NUMBER box-number "1") (STRING copyright "(c) 2020-present by Detlef Stern <ds@zettelstore.de>") (TIMESTAMP created "20210810155955") (ZID-SET forward ("00001007040000" "00001007040310" "00001007040324")) (WORD lang "en") (EMPTY-STRING license "EUPL-1.2-or-later") (TIMESTAMP modified "20220218133206") (TIMESTAMP published "20220218133206") (WORD visibility "public")) (BLOCK (PARA (TEXT "A mark allows to name a point within a zettel.") (SOFT) (TEXT "This is useful if you want to reference some content in a zettel, either with a ") (LINK-ZETTEL () "00001007040310" (TEXT "link")) (TEXT " or with an ") (LINK-ZETTEL () "00001007040324" (TEXT "inline-mode transclusion")) (TEXT ".")) (PARA (TEXT "A mark begins with a left square bracket, followed by an exclamation mark character (") (FORMAT-QUOTE () (LITERAL-INPUT () "!")) (TEXT ", U+0021).") (SOFT) (TEXT "Now the optional mark name follows.") (SOFT) (TEXT "It is a (possibly empty) sequence of Unicode letters, Unicode digits, the hyphen-minus character (") (FORMAT-QUOTE () (LITERAL-INPUT () "-")) (TEXT ", U+002D), or the low-line character (") (FORMAT-QUOTE () (LITERAL-INPUT () "_")) (TEXT ", U+005F).") (SOFT) (TEXT "An optional text to be explicitly marked is introduced with a vertical bar character (") (FORMAT-QUOTE () (LITERAL-INPUT () "|")) (TEXT ", U+007C), followed by some ") (LINK-ZETTEL () "00001007040000" (TEXT "inline-structured elements")) (TEXT ".") (SOFT) (TEXT "The mark element ends with a right square bracket.")) (PARA (TEXT "Examples:")) (UNORDERED (INLINE (LITERAL-CODE () "[!]") (TEXT " is a mark without a name, the empty mark.")) (INLINE (LITERAL-CODE () "[!mark]") (TEXT " is a mark with the name ") (FORMAT-QUOTE () (TEXT "mark")) (TEXT ".")) (INLINE (LITERAL-CODE () "[!|some text]") (TEXT "is the empty mark with ") (FORMAT-QUOTE () (TEXT "some text")) (TEXT ".")) (INLINE (LITERAL-CODE () "[!mark|some text]") (TEXT "is a mark with the name ") (FORMAT-QUOTE () (TEXT "mark")) (TEXT " and with ") (FORMAT-QUOTE () (TEXT "some text")) (TEXT " that is marked.")))))