Zettelmarkup: Inline-mode Transclusion

Inline-mode transclusion is applied to any zettel that is parsed in a non-trivial way, such as when the content is structured text. For instance, this applies to zettel written in Zettelmarkup or Markdown.

Since this type of transclusion involves inline-structured elements, the transclusion specification must be replaced with an appropriate inline-structured content. Specifically, the transclusion specification is replaced with an inline span containing the inline-structured content.

The process begins by reading the referenced zettel. If the zettel contains other transclusions, these will be expanded recursively. If an infinite recursion is detected, the expansion is halted, and an error message replaces the transclusion specification.

The result of this (indirect) transclusion is searched for inline-structured elements.

• If only a zettel identifier was specified, the first top-level paragraph is used. Since a paragraph is basically a sequence of inline-structured elements, these elements will replace the transclude specification.

  Example: {{00010000000000}} (see 00010000000000) is rendered as You will find the latest information about Zettelstore at https://zettelstore.de/. Check its website regularly for updates to the latest version. You should consult the change log before updating. Sometimes, you have to edit some of your Zettelstore-related zettel before updating..

• If a fragment identifier was additionally specified, the element with the given fragment is searched:

  • If it specifies a heading, the next top-level paragraph is used.

    Example: {{00010000000000#reporting-errors}} is rendered as If you have encountered an error, please include the content of the following zettel in your mail (if possible):.

  • In case the fragment names a mark, the inline-structured elements after the mark are used. Initial spaces and line breaks are ignored in this case.

    Example: {{00001007040322#spin}} is rendered as {{Spinning Emoji|00000000040001}}{title=Emoji width=30} is rendered as ..

  • Just specifying the fragment identifier will reference something on the current page. This is not allowed, to prevent a possible endless recursion.

• If the reference is a hosted or based link / URL to an image, that image will be rendered.

  Example: {{//z/00000000040001}}{alt=Emoji} is rendered as

If no inline-structured elements are found, the transclude specification is replaced by an error message.

To avoid an exploding “transclusion bomb”, a form of billion laughs attack (also known as “XML bomb”), the total number of transclusions / expansions is limited. The limit can be controlled by setting the value max-transclusions of the runtime configuration zettel.

See also

Full transclusion does not work inside some text, but is used for block-structured elements.