((p (a (@ (href . "00001007000000")) "Zettelmarkup") " allows you to leave your text as it is, at least in many situations." " " "Some characters have a special meaning, but you have to enter them is a defined way to see a visible change." " " "Zettelmarkup is designed to be used for zettel, which are relatively short." " " "It allows to produce longer texts, but you should probably use a different tool, if you want to produce an scientific paper, to name an example.") (h2 (@ (id . "paragraphs")) "Paragraphs") (p "The most important concept of Zettelmarkup is the " (em "paragraph") "." " " "Ordinary text is interpreted as part of a paragraph." " " "Paragraphs are typically separated by one or more blank lines.") (p "Therefore, line endings are more or less ignored within one paragraph." " " "Zettelmarkup will recognize the end of a line, and sore it as a \"\"soft break\"." " " "A soft break is rendered in most cases as a space character.") (p "Within a paragraph you can style your text with " (a (@ (href . "00001007040000")) "special markup") "." " " "Some examples:") (table (thead (tr (th "Zettelmarkup") (th "Rendered output") (th "Instruction"))) (tbody (tr (td (kbd "An __emphasized__ word")) (td "An " (em "emphasized") " word") (td "Put two underscore characters before and after the text you want to emphasize")) (tr (td (kbd "Someone uses **bold** text")) (td "Someone uses " (strong "bold") " text") (td "Put two asterisks before and after the text you want to see bold")) (tr (td (kbd "He says: \"\"I love you!\"\"")) (td "Her says: " (@L (@H "“") "I love you!" (@H "”"))) (td "Put two quotation mark characters before and after the text you want to quote.")))) (p "You probably see a principle.") (p "One nice thing about the quotation mark characters: they are rendered according to the current language." " " "Examples: " (span (@ (lang . "en")) (@H "“") "english" (@H "”")) ", " (span (@ (lang . "fr")) (@H "«" " ") "french" (@H " " "»")) ", " (span (@ (lang . "de")) (@H "„") "german" (@H "“")) "." " " "You will see later, how to change the current language.") (h2 (@ (id . "lists")) "Lists") (p "Quite often, text consists of lists." " " "Zettelmarkup supports different types of lists." " " "The most important lists are:") (ul (li "Unnumbered lists,") (li "Numbered lists.")) (p "You produce an unnumbered list element by writing an asterisk character followed by a space character at the beginning of a line." " " "Since a list typically consists of more than one element, the following elements will also start at their own line:") (pre (code (@ (class . "language-zmk")) "* First item\n* Second item\n* Third item")) (p "This is rendered as:") (div (@ (class . "example")) (ul (li "First item") (li "Second item") (li "Third item"))) (p "Similar, an numbered list element begins a line with the number sign (sic!) followed by a space character:") (pre (code (@ (class . "language-zmk")) "# First item\n# Second item\n# Third item")) (p "This is rendered as:") (div (@ (class . "example")) (ol (li "First item") (li "Second item") (li "Third item"))) (hr) (p "After trying out these markup elements, you might want to continue with the " (a (@ (href . "00001007906000")) "second steps") "."))