((META (EMPTY-STRING title "Markdown Encoding") (WORD role "manual") (TAG-SET tags ("#api" "#manual" "#reference" "#zettelstore")) (WORD syntax "zmk") (ZID-SET back ("00001004051200" "00001012920500")) (ZID-SET backward ("00001004051200" "00001012920500")) (NUMBER box-number "1") (STRING copyright "(c) 2020-present by Detlef Stern <ds@zettelstore.de>") (TIMESTAMP created "20221107183011") (ZID-SET forward ("00001007000000" "00001007030100" "00001007030200" "00001007030700" "00001007030800" "00001007030900" "00001007031000" "00001007031300" "00001007031400" "00001007040100" "00001007040200" "00001008000000" "00001008010500")) (WORD lang "en") (EMPTY-STRING license "EUPL-1.2-or-later") (TIMESTAMP modified "20221107185130") (TIMESTAMP published "20221107185130") (WORD visibility "public")) (BLOCK (PARA (TEXT "A zettel representation that tries to recreate a ") (LINK-ZETTEL () "00001008010500" (TEXT "Markdown")) (TEXT " representation of the zettel.") (SOFT) (TEXT "Useful if you want to convert ") (LINK-ZETTEL () "00001008000000" (TEXT "other markup languages")) (TEXT " to Markdown (e.g. ") (LINK-ZETTEL () "00001007000000" (TEXT "Zettelmarkup")) (TEXT ").")) (PARA (TEXT "If transferred via HTTP, the content type will be ") (LITERAL-INPUT () "text/markdown") (TEXT ".")) (PARA (TEXT "Please note that many elements of Zettelmarkup cannot be encoded in Markdown / CommonMark.") (SOFT) (TEXT "Examples are:")) (UNORDERED (INLINE (LINK-ZETTEL () "00001007030100" (TEXT "Description lists"))) (INLINE (LINK-ZETTEL () "00001007030700" (TEXT "Verse blocks"))) (INLINE (LINK-ZETTEL () "00001007030800" (TEXT "Region blocks"))) (INLINE (LINK-ZETTEL () "00001007030900" (TEXT "Comment blocks")) (TEXT " (and inline comments)")) (INLINE (LINK-ZETTEL () "00001007031300" (TEXT "Evaluation blocks"))) (INLINE (LINK-ZETTEL () "00001007031400" (TEXT "Math-mode blocks"))) (INLINE (LINK-ZETTEL () "00001007031000" (TEXT "Tables"))) (INLINE (TEXT "Most ") (LINK-ZETTEL () "00001007040100" (TEXT "text formatting")) (TEXT " elements (except emphasis and quotation)")) (INLINE (TEXT "Most ") (LINK-ZETTEL () "00001007040200" (TEXT "literal-like formatting")) (TEXT " (except literal text / code spans)"))) (PARA (TEXT "Some elements are restricted, e.g. ") (LINK-ZETTEL () "00001007030200" (TEXT "quotation lists")) (TEXT " are only supported as a top-level element.")) (PARA (TEXT "Restricted and unsupported elements are not encoded.") (SOFT) (TEXT "They will not appear on the encoded output.")) (PARA (TEXT "Maybe in the future, ignored elements may be shown as an HTML-like comment."))))