(zettel (meta (back "00001000000000 00001006000000 00001006036500 00001007040324 00001007903000 00001007906000 00001008000000 00001012920513 00001012920522 00001017000000") (backward "00001000000000 00001006000000 00001006036500 00001007040324 00001007903000 00001007906000 00001008000000 00001008010500 00001012920513 00001012920522 00001017000000") (box-number "1") (created "20210126175322") (forward "00001007010000 00001007020000 00001007030000 00001007040000 00001007050000 00001007700000 00001007800000 00001007900000 00001007990000 00001008010000 00001008010500") (modified "20241212152823") (published "20241212152823") (role "manual") (syntax "zmk") (tags "#manual #zettelmarkup #zettelstore") (title "Zettelmarkup")) (rights 4) (encoding "") (content "Zettelmarkup is a rich plain-text based markup language for writing zettel content.\nBesides the zettel content, Zettelmarkup is also used for specifying the title of a zettel, regardless of the syntax of a zettel.\n\nZettelmarkup supports the longevity of stored notes by providing a syntax that any person can easily read, as well as a computer.\nZettelmarkup can be much easier parsed / consumed by a software compared to other markup languages.\nWriting a parser for [[Markdown|https://daringfireball.net/projects/markdown/syntax]] is quite challenging.\n[[CommonMark|00001008010500]] is an attempt to make it simpler by providing a comprehensive specification, combined with an extra chapter to give hints for the implementation.\nZettelmarkup follows some simple principles that anybody who knows how ho write software should be able understand to create an implementation.\n\nZettelmarkup is a markup language on its own.\nThis is in contrast to Markdown, which is basically a super-set of HTML: every HTML document is a valid Markdown document.[^To be precise: the content of the ```` of each HTML document is a valid Markdown document.]\nWhile HTML is a markup language that will probably last for a long time, it cannot be easily translated to other formats, such as PDF, JSON, or LaTeX.\nAdditionally, it is allowed to embed other languages into HTML, such as CSS or even JavaScript.\nThis could create problems with longevity as well as security problems.\n\nZettelmarkup is a rich markup language, but it focuses on relatively short zettel content.\nIt allows embedding other content, simple tables, quotations, description lists, and images.\nIt provides a broad range of inline formatting, including __emphasized__, **strong**, ~~deleted~~{-} and >>inserted>> text.\nFootnotes[^like this] are supported, links to other zettel and to external material, as well as citation keys.\nZettelmarkup allows to include content from other zettel and to embed the result of a search query.\n\nZettelmarkup might be seen as a proprietary markup language.\nBut if you want to use [[Markdown/CommonMark|00001008010000]] and you need support for footnotes or tables, you'll end up with proprietary extensions.\nHowever, the Zettelstore supports CommonMark as a zettel syntax, so you can mix both Zettelmarkup zettel and CommonMark zettel in one store to get the best of both worlds.\n\n* [[General principles|00001007010000]]\n* [[Basic definitions|00001007020000]]\n* [[Block-structured elements|00001007030000]]\n* [[Inline-structured element|00001007040000]]\n* [[Attributes|00001007050000]]\n* [[Query expressions|00001007700000]]\n* [[Summary of formatting characters|00001007800000]]\n* [[Tutorial|00001007900000]]\n* [[Cheat Sheet|00001007990000]]"))