(((meta (@ (content . "Zettelmarkup: Inline-Structured Elements") (name . "title"))) (meta (@ (content . "manual") (name . "role"))) (meta (@ (content . "#manual #zettelmarkup #zettelstore") (name . "tags"))) (meta (@ (content . "zmk") (name . "syntax"))) (meta (@ (content . "00001006020000 00001007000000 00001007010000 00001007030000 00001007030100 00001007030200 00001007030300 00001007030400 00001007030600 00001007030700 00001007030800 00001007031000 00001007031110 00001007040310 00001007040324 00001007040340 00001007040350 00001007800000 00001007903000 00001007990000 00001012931000") (name . "back"))) (meta (@ (content . "00001006020000 00001007000000 00001007010000 00001007030000 00001007030100 00001007030200 00001007030300 00001007030400 00001007030600 00001007030700 00001007030800 00001007031000 00001007031110 00001007040310 00001007040324 00001007040340 00001007040350 00001007050000 00001007800000 00001007903000 00001007990000 00001012931000") (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 . "00001007040100 00001007040200 00001007040300 00001007040330 00001007050000") (name . "forward"))) (meta (@ (content . "en") (name . "lang"))) (meta (@ (content . "EUPL-1.2-or-later") (name . "license"))) (meta (@ (content . "20220920143243") (name . "modified"))) (meta (@ (content . "20220920143243") (name . "published"))) (meta (@ (content . "public") (name . "visibility")))) (p "Most characters you type is concerned with inline-structured elements." " " "The content of a zettel contains is many cases just ordinary text, lightly formatted." " " "Inline-structured elements allow to format your text and add some helpful links or images." " " "Sometimes, you want to enter characters that have no representation on your keyboard.") (dl (dt "Text formatting") (dd (p "Every " (a (@ (href . "00001007040100")) "text formatting") " element begins with two same characters at the beginning." " " "It lasts until the same two characters occurred the second time." " " "Some of these elements explicitly support " (a (@ (href . "00001007050000")) "attributes") ".")) (dt "Literal-like formatting") (dd (p "Sometime you want to enter the text as it is.")) (dd (p "This is the core motivation of " (a (@ (href . "00001007040200")) "literal-like formatting") ".")) (dt "Reference-like text") (dd (p "You can reference other zettel and (external) material within one zettel." " " "This kind of reference may be a link, or an images that is display inline when the zettel is rendered." " " "Footnotes sometimes factor out some useful text that hinders the flow of reading text." " " "Internal marks allow to reference something within a zettel." " " "An important aspect of all knowledge work is to reference others work, e.g. with citation keys." " " "All these elements can be subsumed under " (a (@ (href . "00001007040300")) "reference-like text") "."))) (h2 (@ (id . "other-inline-elements")) "Other inline elements") (h3 (@ (id . "comment")) "Comment") (p "A comment begins with two consecutive percent sign characters (" (@L (@H "&ldquo;") (kbd "%") (@H "&rdquo;")) ", U+0025)." " " "It ends at the end of the line where it begins.") (h3 (@ (id . "backslash")) "Backslash") (p "The backslash character (" (@L (@H "&ldquo;") (kbd "\\") (@H "&rdquo;")) ", U+005C) gives the next character another meaning.") (ul (li "If a space character follows, it is converted in a non-breaking space (U+00A0).") (li "If a line ending follows the backslash character, the line break is converted from a " (em "soft break") " into a " (em "hard break") ".") (li "Every other character is taken as itself, but without the interpretation of a Zettelmarkup element." " " "For example, if you want to enter a " (@L (@H "&ldquo;") (kbd "]") (@H "&rdquo;")) " into a " (a (@ (href . "00001007040330")) "footnote text") ", you should escape it with a backslash.")) (h3 (@ (id . "entities-more")) "Entities & more") (p "Sometimes it is not easy to enter special characters." " " "If you know the Unicode code point of that character, or its name according to the " (a (@ (href . "https://html.spec.whatwg.org/multipage/named-characters.html") (rel . "external")) "HTML standard") ", you can enter it by number or by name.") (p "Regardless which method you use, an entity always begins with an ampersand character (" (@L (@H "&ldquo;") (kbd "&") (@H "&rdquo;")) ", U+0026) and ends with a semicolon character (" (@L (@H "&ldquo;") (kbd ";") (@H "&rdquo;")) ", U+003B)." " " "If you know the HTML name of the character you want to enter, put it between these two character." " " "Example: " (code "&amp;") " is rendered as " (span (@ (class . "example")) "&") ".") (p "If you want to enter its numeric code point, a number sign character must follow the ampersand character, followed by digits to base 10." " " "Example: " (code "&#38;") " is rendered in HTML as " (span (@ (class . "example")) "&") ".") (p "You also can enter its numeric code point as a hex number, if you put the letter " (@L (@H "&ldquo;") "x" (@H "&rdquo;")) " after the numeric sign character." " " "Example: " (code "&#x26;") " is rendered in HTML as " (span (@ (class . "example")) "&") ".") (p "According to the " (a (@ (href . "https://html.spec.whatwg.org/multipage/syntax.html#character-references") (rel . "external")) "HTML Standard") ", some numeric code points are not allowed." " " "These are all code point below the numeric value 32 (decimal) or 0x20 (hex) and all code points for " (a (@ (href . "https://infra.spec.whatwg.org/#noncharacter") (rel . "external")) "noncharacter") " values.") (p "Since some Unicode character are used quite often, a special notation is introduced for them:") (ul (li "Two consecutive hyphen-minus characters result in an " (em "en-dash") " character." " " "It is typically used in numeric ranges." " " (code "pages 4--7") " will be rendered in HTML as: " (span (@ (class . "example")) "pages 4–7") "." " " "Alternative specifications are: " (code "&ndash;") ", " (code "&x8211") ", and " (code "&#x2013") ".")))