(BLOCK (PARA (TEXT "An inline-zettel block allows to specify some content with another syntax without creating a new zettel.") (SOFT) (TEXT "This is useful, for example, if you want to embed some ") (LINK-ZETTEL () "00001008010500" (TEXT "Markdown")) (TEXT " content, because you are too lazy to translate Markdown into Zettelmarkup.") (SOFT) (TEXT "Another example is to specify HTML code to use it for some kind of web front-end framework.")) (PARA (TEXT "As all other ") (LINK-ZETTEL () "00001007030000#line-range-blocks" (TEXT "line-range blocks")) (TEXT ", an inline-zettel block begins with at least three identical characters, starting at the first position of a line.") (SOFT) (TEXT "For inline-zettel blocks, the at-sign character (") (FORMAT-QUOTE () (LITERAL-INPUT () "@")) (TEXT ", U+0040) is used.")) (PARA (TEXT "You can add some ") (LINK-ZETTEL () "00001007050000" (TEXT "attributes")) (TEXT " on the beginning line of a verbatim block, following the initiating characters.") (SOFT) (TEXT "The inline-zettel block uses the attribute key ") (FORMAT-QUOTE () (TEXT "syntax")) (TEXT " to specify the ") (LINK-ZETTEL () "00001008000000" (TEXT "syntax")) (TEXT " of the inline-zettel.") (SOFT) (TEXT "Alternatively, you can use the generic attribute to specify the syntax value.") (SOFT) (TEXT "If no value is provided, ") (FORMAT-QUOTE () (LINK-ZETTEL () "00001008000000#text" (TEXT "text"))) (TEXT " is assumed.")) (PARA (TEXT "Any other character in this first line will be ignored.")) (PARA (TEXT "Text following the beginning line will not be interpreted, until a line begins with at least the same number of the same at-sign characters given at the beginning line.") (SOFT) (TEXT "This allows to enter some at-sign characters in the text that should not be interpreted at this level.")) (PARA (TEXT "Some examples:")) (VERBATIM-CODE (("" . "zmk")) "@@@markdown\nA link to [this](00001007031200) zettel.\n@@@") (PARA (TEXT "will be rendered as:")) (REGION-BLOCK (("" . "example")) ((PARA (TEXT "A link to ") (LINK-ZETTEL () "00001007031200" (TEXT "this")) (TEXT " zettel.")))) (PARA (TEXT "If you have set ") (LINK-ZETTEL () "00001004010000#insecure-html" (LITERAL-INPUT () "insecure-html")) (TEXT " to the value ") (FORMAT-QUOTE () (TEXT "zettelmarkup")) (TEXT ", the following markup is not ignored:")) (VERBATIM-CODE (("" . "zmk")) "@@@html\n<h1>H1 Heading</h1>\nAlea iacta est\n@@@") (PARA (TEXT "will render a section heading of level 1, which is not allowed within Zettelmarkup:")) (REGION-BLOCK (("" . "example")) ((VERBATIM-HTML (("" . "html")) "<h1>H1 Heading</h1>\nAlea iacta est"))) (REGION-BLOCK (("" . "note")) ((PARA (TEXT "Please note: some HTML code will not be fully rendered because of possible security implications.") (SOFT) (TEXT "This include HTML lines that contain a ") (LITERAL-INPUT () "<script>") (TEXT " tag or an ") (LITERAL-INPUT () "<iframe>") (TEXT " tag.")))) (PARA (TEXT "Of course, you do not need to switch the syntax and you are allowed to nest inline-zettel blocks:")) (VERBATIM-CODE (("" . "zmk")) "@@@@zmk\n1st level inline\n@@@zmk\n2nd level inline\n\nTransclusion of zettel to enable authentication:\n{{{00001010040100}}}\n@@@\n@@@@") (PARA (TEXT "will result in the following HTML output:")) (REGION-BLOCK (("" . "example")) ((PARA (TEXT "1st level inline")) (PARA (TEXT "2nd level inline")) (PARA (TEXT "Transclusion of zettel to enable authentication:")) (PARA (TEXT "To enable authentication, you must create a zettel that stores ") (LINK-ZETTEL () "00001010040200" (TEXT "authentication data")) (TEXT " for the owner.") (SOFT) (TEXT "Then you must reference this zettel within the ") (LINK-ZETTEL () "00001004010000#owner" (TEXT "startup configuration")) (TEXT " under the key ") (LITERAL-INPUT () "owner") (TEXT ".") (SOFT) (TEXT "Once the startup configuration contains a valid ") (LINK-ZETTEL () "00001006050000" (TEXT "zettel identifier")) (TEXT " under that key, authentication is enabled.")) (PARA (TEXT "Please note that you must also set key ") (LITERAL-INPUT () "secret") (TEXT " of the ") (LINK-ZETTEL () "00001004010000#secret" (TEXT "startup configuration")) (TEXT " to some random string data (minimum length is 16 bytes) to secure the data exchanged with a client system.")))))