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