(((meta (@ (content . "Zettelmarkup: Second Steps") (name . "title"))) (meta (@ (content . "manual") (name . "role"))) (meta (@ (content . "#manual #tutorial #zettelmarkup #zettelstore") (name . "tags"))) (meta (@ (content . "zmk") (name . "syntax"))) (meta (@ (content . "00001007900000") (name . "back"))) (meta (@ (content . "00001007900000 00001007903000") (name . "backward"))) (meta (@ (content . "1") (name . "box-number"))) (meta (@ (content . "(c) 2020-present by Detlef Stern <ds@zettelstore.de>") (name . "copyright"))) (meta (@ (content . "20220811115501") (name . "created"))) (meta (@ (content . "00001006050000 00001007000000 00001007030000 00001007030300 00001007040310 00001007903000") (name . "forward"))) (meta (@ (content . "en") (name . "lang"))) (meta (@ (content . "EUPL-1.2-or-later") (name . "license"))) (meta (@ (content . "20220926183427") (name . "modified"))) (meta (@ (content . "20220926183427") (name . "published"))) (meta (@ (content . "public") (name . "visibility")))) (p "After" " " "you" " " "have" " " (a (@ (href . "00001007903000")) "learned") " " "the" " " "basic" " " "concepts" " " "and" " " "markup" " " "of" " " "Zettelmarkup" " " "(paragraphs," " " "emphasized" " " "text," " " "and" " " "lists)," " " "this" " " "zettel" " " "introduces" " " "you" " " "into" " " "the" " " "concepts" " " "of" " " "links," " " "thematic" " " "breaks," " " "and" " " "headings.") (h2 (@ (id . "links")) "Links") (p "A" " " "Zettelstore" " " "is" " " "much" " " "more" " " "useful," " " "if" " " "you" " " "connect" " " "related" " " "zettel." " " "If" " " "you" " " "read" " " "a" " " "zettel" " " "later," " " "this" " " "allows" " " "you" " " "to" " " "know" " " "about" " " "the" " " "context" " " "of" " " "a" " " "zettel." " " (a (@ (href . "00001007000000")) "Zettelmarkup") " " "allows" " " "you" " " "to" " " "specify" " " "such" " " "a" " " "connection." " " "A" " " "connection" " " "can" " " "be" " " "specified" " " "within" " " "a" " " "paragraph" " " "via" " " (a (@ (href . "00001007040310")) "Links") ".") (ul (li "A" " " "link" " " "always" " " "starts" " " "with" " " "two" " " "left" " " "square" " " "bracket" " " "characters" " " "and" " " "ends" " " "with" " " "two" " " "right" " " "square" " " "bracket" " " "characters:" " " (kbd "[[...]]") ".") (li "Within" " " "these" " " "character" " " "sequences" " " "you" " " "specify" " " "the" " " (a (@ (href . "00001006050000")) "zettel" " " "identifier") " " "of" " " "the" " " "zettel" " " "you" " " "want" " " "to" " " "reference:" " " (kbd "[[00001007903000]]") " " "will" " " "connect" " " "to" " " "zettel" " " "containing" " " "the" " " "first" " " "steps" " " "into" " " "Zettelmarkup.") (li "In" " " "addition," " " "you" " " "should" " " "give" " " "the" " " "link" " " "a" " " "more" " " "readable" " " "description." " " "This" " " "is" " " "done" " " "by" " " "prepending" " " "the" " " "description" " " "before" " " "the" " " "reference" " " "and" " " "use" " " "the" " " "vertical" " " "bar" " " "character" " " "to" " " "separate" " " "both:" " " (kbd "[[First Steps|00001007903000]]") ".")) (p "You" " " "are" " " "not" " " "restricted" " " "to" " " "reference" " " "your" " " "zettel." " " "Alternatively," " " "you" " " "might" " " "specify" " " "an" " " "URL" " " "of" " " "an" " " "external" " " "website:" " " (kbd "[[Zettelstore|https://zettelstore.de]]") "." " " "Of" " " "course," " " "if" " " "you" " " "just" " " "want" " " "to" " " "specify" " " "the" " " "URL," " " "you" " " "are" " " "allowed" " " "to" " " "omit" " " "the" " " "description:" " " (kbd "[[https://zettelstore.de]]")) (table (thead (tr (td "Zettelmarkup") (td "Rendered" " " "output") (td "Remark"))) (tbody (tr (td (kbd "[[00001007903000]]")) (td (a (@ (href . "00001007903000")) "00001007903000")) (td "If" " " "no" " " "description" " " "is" " " "given," " " "the" " " "zettel" " " "identifier" " " "acts" " " "as" " " "a" " " "description")) (tr (td (kbd "[[First Steps|00001007903000]]")) (td (a (@ (href . "00001007903000")) "First" " " "Steps")) (td "The" " " "description" " " "should" " " "be" " " "chosen" " " "so" " " "that" " " "you" " " "are" " " "not" " " "confused" " " "later")) (tr (td (kbd "[[https://zettelstore.de]]")) (td (a (@ (class . "external") (href . "https://zettelstore.de")) "https://zettelstore.de")) (td "A" " " "link" " " "to" " " "an" " " "external" " " "URL" " " "is" " " "rendered" " " "differently")) (tr (td (kbd "[[Zettelstore|https://zettelstore.de]]")) (td (a (@ (class . "external") (href . "https://zettelstore.de")) "Zettelstore")) (td "You" " " "can" " " "use" " " "any" " " "URL" " " "your" " " "browser" " " "is" " " "able" " " "to" " " "support")))) (p "Again," " " "you" " " "probably" " " "see" " " "a" " " "principle.") (h2 (@ (id . "thematic-breaks")) "Thematic" " " "Breaks") (p (a (@ (class . "external") (href . "https://en.wikipedia.org/wiki/And_Now_for_Something_Completely_Different")) "And" " " "now" " " "for" " " "something" " " "completely" " " "different") ".") (p "Sometimes," " " "you" " " "want" " " "to" " " "insert" " " "a" " " "thematic" " " "break" " " "into" " " "your" " " "text," " " "because" " " "two" " " "paragraphs" " " "do" " " "not" " " "separate" " " "enough." " " "In" " " "Zettelmarkup" " " "is" " " "is" " " "done" " " "by" " " "entering" " " "three" " " "or" " " "more" " " "hyphen-minus" " " "characters" " " "at" " " "the" " " "beginning" " " "of" " " "a" " " "new" " " "line." " " "You" " " "must" " " "not" " " "include" " " "blank" " " "lines" " " "around" " " "this" " " "line," " " "but" " " "it" " " "can" " " "be" " " "more" " " "readable" " " "if" " " "you" " " "want" " " "to" " " "look" " " "at" " " "the" " " "Zettelmarkup" " " "text.") (pre (code (@ (class . "language-zmk")) "First paragraph.\n---\nSecond paragraph.")) (pre (code (@ (class . "language-zmk")) "First paragraph.\n\n---\n\nSecond paragraph.")) (p "Both" " " "are" " " "rendered" " " "as:") (div (@ (class . "example")) (p "First" " " "paragraph.") (hr) (p "Second" " " "paragraph.")) (p "Try" " " "it!") (p "This" " " "might" " " "be" " " "the" " " "time" " " "to" " " "relax" " " "a" " " "rule" " " "about" " " "paragraphs." " " "You" " " "must" " " "not" " " "specify" " " "a" " " "blank" " " "line" " " "to" " " "end" " " "a" " " "paragraph." " " "Any" " " "Zettelmarkup" " " "that" " " "must" " " "start" " " "at" " " "the" " " "beginning" " " "of" " " "a" " " "new" " " "line" " " "will" " " "end" " " "a" " " "previous" " " "paragraph." " " "Similar," " " "a" " " "blank" " " "line" " " "must" " " "not" " " "precede" " " "a" " " "paragraph.") (p "This" " " "applies" " " "also" " " "to" " " "lists," " " "as" " " "given" " " "in" " " "the" " " "first" " " "steps," " " "as" " " "well" " " "as" " " "other" " " (a (@ (href . "00001007030000")) "similar" " " "markup") " " "you" " " "will" " " "probably" " " "later.") (h2 (@ (id . "headings")) "Headings") (p "Headings" " " "explicitly" " " "structure" " " "a" " " "zettel," " " "similar" " " "to" " " "thematic" " " "breaks," " " "but" " " "gives" " " "the" " " "resulting" " " "part" " " "a" " " "name.") (p "To" " " "specify" " " "a" " " "heading" " " "in" " " "Zettelmarkup," " " "you" " " "must" " " "enter" " " "at" " " "least" " " "three" " " "equal" " " "signs," " " "followed" " " "by" " " "a" " " "space," " " "followed" " " "by" " " "the" " " "text" " " "of" " " "the" " " "heading." " " "Everything" " " "must" " " "be" " " "one" " " "the" " " "same" " " "line.") (p "The" " " "number" " " "of" " " "equal" " " "signs" " " "determines" " " "the" " " "importance" " " "of" " " "the" " " "heading:" " " "less" " " "equal" " " "signs" " " "means" " " "more" " " "important." " " "Therefore," " " "three" " " "equal" " " "signs" " " "treat" " " "a" " " "heading" " " "as" " " "most" " " "important." " " "It" " " "is" " " "a" " " "level-1" " " "heading." " " "Zettelmarkup" " " "supports" " " "up" " " "to" " " "five" " " "levels." " " "To" " " "specify" " " "such" " " "a" " " "heading," " " "you" " " "must" " " "enter" " " "seven" " " "equal" " " "signs," " " "plus" " " "the" " " "space" " " "and" " " "the" " " "text." " " "If" " " "you" " " "enter" " " "more" " " "than" " " "seven" " " "equal" " " "signs," " " "the" " " "resulting" " " "heading" " " "is" " " "still" " " "of" " " "level" " " "5.") (p "See" " " "the" " " (a (@ (href . "00001007030300")) "description" " " "of" " " "headings") " " "for" " " "more" " " "details" " " "and" " " "examples."))