(zettel (meta (back "00001007900000") (backward "00001007900000 00001007903000") (box-number "1") (created "20220811115501") (forward "00001006050000 00001007000000 00001007030000 00001007030300 00001007040310 00001007903000") (modified "20220926183427") (published "20220926183427") (role "manual") (syntax "zmk") (tags "#manual #tutorial #zettelmarkup #zettelstore") (title "Zettelmarkup: Second Steps")) (rights 4) (encoding "") (content "After you have [[learned|00001007903000]] 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.\n\n=== Links\nA Zettelstore is much more useful, if you connect related zettel.\nIf you read a zettel later, this allows you to know about the context of a zettel.\n[[Zettelmarkup|00001007000000]] allows you to specify such a connection.\nA connection can be specified within a paragraph via [[Links|00001007040310]].\n\n* A link always starts with two left square bracket characters and ends with two right square bracket characters: ''[[...]]''.\n* Within these character sequences you specify the [[zettel identifier|00001006050000]] of the zettel you want to reference: ''[[00001007903000]]'' will connect to zettel containing the first steps into Zettelmarkup.\n* In addition, you should give the link a more readable description.\n  This is done by prepending the description before the reference and use the vertical bar character to separate both: ''[[First Steps|00001007903000]]''.\n\nYou are not restricted to reference your zettel.\nAlternatively, you might specify an URL of an external website: ''[[Zettelstore|https://zettelstore.de]]''.\nOf course, if you just want to specify the URL, you are allowed to omit the description: ''[[https://zettelstore.de]]''\n\n|= Zettelmarkup | Rendered output | Remark\n| ''[[00001007903000]]'' | [[00001007903000]] | If no description is given, the zettel identifier acts as a description\n| ''[[First Steps|00001007903000]]'' | [[First Steps|00001007903000]] | The description should be chosen so that you are not confused later\n| ''[[https://zettelstore.de]]'' | [[https://zettelstore.de]] | A link to an external URL is rendered differently\n| ''[[Zettelstore|https://zettelstore.de]]'' | [[Zettelstore|https://zettelstore.de]] | You can use any URL your browser is able to support\n\nAgain, you probably see a principle.\n\n=== Thematic Breaks\n[[And now for something completely different|https://en.wikipedia.org/wiki/And_Now_for_Something_Completely_Different]].\n\nSometimes, you want to insert a thematic break into your text, because two paragraphs do not separate enough.\nIn Zettelmarkup is is done by entering three or more hyphen-minus characters at the beginning of a new line.\nYou must not include blank lines around this line, but it can be more readable if you want to look at the Zettelmarkup text.\n\n```zmk\nFirst paragraph.\n---\nSecond paragraph.\n```\n\n```zmk\nFirst paragraph.\n\n---\n\nSecond paragraph.\n```\n\nBoth are rendered as:\n:::example\nFirst paragraph.\n---\nSecond paragraph.\n:::\n\nTry it!\n\nThis might be the time to relax a rule about paragraphs.\nYou must not specify a blank line to end a paragraph.\nAny Zettelmarkup that must start at the beginning of a new line will end a previous paragraph.\nSimilar, a blank line must not precede a paragraph.\n\nThis applies also to lists, as given in the first steps, as well as other [[similar markup|00001007030000]] you will probably later.\n\n=== Headings\nHeadings explicitly structure a zettel, similar to thematic breaks, but gives the resulting part a name.\n\nTo specify a heading in Zettelmarkup, you must enter at least three equal signs, followed by a space, followed by the text of the heading.\nEverything must be one the same line.\n\nThe number of equal signs determines the importance of the heading: less equal signs means more important.\nTherefore, three equal signs treat a heading as most important.\nIt is a level-1 heading.\nZettelmarkup supports up to five levels.\nTo specify such a heading, you must enter seven equal signs, plus the space and the text.\nIf you enter more than seven equal signs, the resulting heading is still of level 5.\n\nSee the [[description of headings|00001007030300]] for more details and examples."))