((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 "“") (kbd "%") (@H "”")) ", U+0025)." " " "It ends at the end of the line where it begins.") (h3 (@ (id . "backslash")) "Backslash") (p "The backslash character (" (@L (@H "“") (kbd "\\") (@H "”")) ", 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 "“") (kbd "]") (@H "”")) " 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 "“") (kbd "&") (@H "”")) ", U+0026) and ends with a semicolon character (" (@L (@H "“") (kbd ";") (@H "”")) ", U+003B)." " " "If you know the HTML name of the character you want to enter, put it between these two character." " " "Example: " (code "&") " 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 "&") " 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 "“") "x" (@H "”")) " after the numeric sign character." " " "Example: " (code "&") " 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 "–") ", " (code "&x8211") ", and " (code "&#x2013") ".")))