((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 (th "Zettelmarkup") (th "Rendered output") (th "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 (@ (href . "https://zettelstore.de") (rel . "external")) "https://zettelstore.de")) (td "A link to an external URL is rendered differently")) (tr (td (kbd "[[Zettelstore|https://zettelstore.de]]")) (td (a (@ (href . "https://zettelstore.de") (rel . "external")) "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 (@ (href . "https://en.wikipedia.org/wiki/And_Now_for_Something_Completely_Different") (rel . "external")) "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."))