title: Markdown Encoding
role: manual
tags: #api #manual #reference #zettelstore
syntax: zmk
back: 00001004051200 00001012920500
backward: 00001004051200 00001012920500
box-number: 1
copyright: (c) 2020-present by Detlef Stern <ds@zettelstore.de>
created: 20221107183011
forward: 00001007000000 00001007030100 00001007030200 00001007030700 00001007030800 00001007030900 00001007031000 00001007031300 00001007031400 00001007040100 00001007040200 00001008000000 00001008010500
lang: en
license: EUPL-1.2-or-later
modified: 20221107185130
published: 20221107185130
visibility: public

A zettel representation that tries to recreate a [[Markdown|00001008010500]] representation of the zettel.
Useful if you want to convert [[other markup languages|00001008000000]] to Markdown (e.g. [[Zettelmarkup|00001007000000]]).

If transferred via HTTP, the content type will be ''text/markdown''.

Please note that many elements of Zettelmarkup cannot be encoded in Markdown / CommonMark.
Examples are:
* [[Description lists|00001007030100]]
* [[Verse blocks|00001007030700]]
* [[Region blocks|00001007030800]]
* [[Comment blocks|00001007030900]] (and inline comments)
* [[Evaluation blocks|00001007031300]]
* [[Math-mode blocks|00001007031400]]
* [[Tables|00001007031000]]
* Most [[text formatting|00001007040100]] elements (except emphasis and quotation)
* Most [[literal-like formatting|00001007040200]] (except literal text / code spans)
Some elements are restricted, e.g. [[quotation lists|00001007030200]] are only supported as a top-level element.

Restricted and unsupported elements are not encoded.
They will not appear on the encoded output.

Maybe in the future, ignored elements may be shown as an HTML-like comment.