title: Zettelmarkup: Inline-Structured Elements
role: manual
tags: #manual #zettelmarkup #zettelstore
syntax: zmk
back: 00001007000000 00001007010000 00001007030000 00001007030100 00001007030200 00001007030300 00001007030400 00001007030600 00001007030700 00001007030800 00001007031000 00001007031110 00001007040310 00001007040324 00001007040340 00001007040350 00001007800000 00001007903000 00001007990000 00001012931000
backward: 00001007000000 00001007010000 00001007030000 00001007030100 00001007030200 00001007030300 00001007030400 00001007030600 00001007030700 00001007030800 00001007031000 00001007031110 00001007040310 00001007040324 00001007040340 00001007040350 00001007050000 00001007800000 00001007903000 00001007990000 00001012931000
box-number: 1
copyright: (c) 2020-present by Detlef Stern <ds@zettelstore.de>
created: 20210126175322
forward: 00001007040100 00001007040200 00001007040300 00001007040330 00001007050000
lang: en
license: EUPL-1.2-or-later
modified: 20260302155410
published: 20260302155410
visibility: public

Most characters you type are concerned with inline-structured elements.
The content of a zettel contains in many cases just ordinary text, lightly formatted.
Inline-structured elements make it possible to format your text and add some helpful links or images.
Sometimes, you want to enter characters that have no representation on your keyboard.



# Other inline elements

## Comment

A comment begins with two consecutive percent sign characters (&ldquo;`%`&rdquo;, U+0025).
It ends at the end of the line where it begins.

If a line ends with an empty comment, the line break is converted from a *soft break* into a *hard break*.
An empty comment either contains no text at all or only whitespace characters.

## Backslash

The backslash character (&ldquo;`\`&rdquo;, U+005C) gives the next character another meaning.

* If a space character follows, it is converted into a non-breaking space (U+00A0).
* Every other character is taken as itself, but without the interpretation of a Zettelmarkup element.
  For example, if you want to enter a &ldquo;`]`&rdquo; into a [footnote text](00001007040330), you should escape it with a backslash.

## Entities & more

Sometimes it is not easy to enter special characters.
If you know the Unicode code point of that character, or its name according to the [HTML standard](https://html.spec.whatwg.org/multipage/named-characters.html), you can enter it by number or by name.

Regardless which method you use, an entity always begins with an ampersand character (&ldquo;`&`&rdquo;, U+0026) and ends with a semicolon character (&ldquo;`;`&rdquo;, U+003B).
If you know the HTML name of the character you want to enter, put it between these two characters.
Example: `&amp;` is rendered as &.

If you want to enter its numeric code point, a number sign character must follow the ampersand character, followed by digits to base 10.
Example: `&#38;` is rendered in HTML as &.

You also can enter its numeric code point as a hex number, if you put the letter &ldquo;x&rdquo; after the numeric sign character.
Example: `&#x26;` is rendered in HTML as &.

According to the [HTML Standard](https://html.spec.whatwg.org/multipage/syntax.html#character-references), some numeric code points are not allowed.
These are all code point below the numeric value 32 (decimal) or 0x20 (hex) and all code points for [noncharacter](https://infra.spec.whatwg.org/#noncharacter) values.

Since some Unicode characters are used quite often, a special notation is introduced for them:

* Two consecutive hyphen-minus characters result in an *en-dash* character.
  It is typically used in numeric ranges.
  `pages 4--7` will be rendered in HTML as: pages 4–7.
  Alternative specifications are: `&ndash;`, `&#x8211;`, and `&#x2013;`.