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.