Encoding of Sz Inline Elements
manual
api manual reference zettelstore
zmk
00001012931400
00001012931000 00001012931400
1
(c) 2020-present by Detlef Stern <ds@zettelstore.de>
20230403161845
00001012931000 00001012931600 00001012931900
en
EUPL-1.2-or-later
20250313130428
20250313130428
public
TEXT
Text = (TEXT String ).
Specifies the string as some text content, including white space characters.
SOFT
Soft = (SOFT).
Denotes a soft line break. It will be often encoded as a space character, but signals the point in the textual content, where a line break occurred.
HARD
Hard = (HARD).
Specifies a hard line break, i.e. the user wants to have a line break here.
LINK
Link = (LINK Attributes Reference InlineElement … ).
Specifies a link to some other material. The link type is based on the full reference. The trailing sequence of InlineElements contains the linked text.
EMBED
Embed = (EMBED Attributes Reference String InlineElement … ).
Specifies an embedded element, in most cases some image content or an inline transclusion. A transclusion will only be used, if the zettel content was not evaluated.
Reference denoted the referenced zettel.
If the string value is empty, it is an inline transclusion. Otherwise it contains the syntax of an image.
The InlineElement at the end of the list is interpreted as describing text.
EMBED-BLOB
EmbedBLOB = (EMBED-BLOB Attributes String1 String2 ).
If used if some processed image has to be embedded inside some inline material. The first string specifies the syntax of the image content. The second string contains the image content. If the syntax is SVG, the image content is not encoded further. Otherwise a base64 encoding is used.
CITE
CiteBLOB = (CITE Attributes String InlineElement … ).
The string contains the citation key.
MARK
Mark = (MARK String1 String2 String3 InlineElement … ).
The first string is the mark string used in the content. The second string is the mark string transformed to a slug, i.e. transformed to lower case, remove non-ASCII characters. The third string is the slug string, but made unique for the whole zettel. Then follows the marked text as a sequence of InlineElements.
ENDNOTE
Endnote = (ENDNOTE Attributes InlineElement … ).
Specifies endnote / footnote text.
FORMAT-*
The following lists specifies some inline text formatting. The structure is always the same, the initial symbol denotes the actual formatting.
DeleteFormat = (FORMAT-DELETE Attributes InlineElement … ).
The inline text should be treated as deleted.
EmphasizeFormat = (FORMAT-EMPH Attributes InlineElement … ).
The inline text should be treated as emphasized.
InsertFormat = (FORMAT-INSERT Attributes InlineElement … ).
The inline text should be treated as inserted.
MarkFormat = (FORMAT-MARK Attributes InlineElement … ).
The inline text should be treated as highlighted for the reader (but was not important to the original author).
QuoteFormat = (FORMAT-QUOTE Attributes InlineElement … ).
The inline text should be treated as quoted text.
SpanFormat = (FORMAT-SPAN Attributes InlineElement … ).
The inline text should be treated as belonging together in a certain, yet unspecified way.
SubScriptFormat = (FORMAT-SUB Attributes InlineElement … ).
The inline text should be treated as sub-scripted text.
SuperScriptFormat = (FORMAT-SUPER Attributes InlineElement … ).
The inline text should be treated as super-scripted text.
StrongFormat = (FORMAT-STRONG Attributes InlineElement … ).
The inline text should be treated as strongly emphasized.
LITERAL-*
The following lists specifies some literal text. The structure is always the same, the initial symbol denotes the actual usage.
CodeLiteral = (LITERAL-CODE Attributes String ).
The string contains text that should be treated as executable code.
CommentLiteral = (LITERAL-COMMENT Attributes String ).
The string contains text that should be treated as an internal comment not to be interpreted further.
HTMLLiteral = (LITERAL-HTML Attributes String ).
The string contains text that should be treated as HTML code.
InputLiteral = (LITERAL-INPUT Attributes String ).
The string contains text that should be treated as input entered by a user.
MathLiteral = (LITERAL-MATH Attributes String ).
The string contains text that should be treated as special code to be interpreted as mathematical formulas.
OutputLiteral = (LITERAL-OUTPUT Attributes String ).
The string contains text that should be treated as computer output to be read by a user.
ZettelLiteral = (LITERAL-ZETTEL Attributes String ).
The string contains text that should be treated as (nested) zettel content.