First rule

Blank lines divide logical blocks (e.g. paragraphs including asides).

Types of plugins

(1) Import external markdown file or plugin

:--- ---:


:--- PLUGIN | config.yaml ---:

(2) Plugin within the text

:--- PLUGIN ---:
param1: abc
param2: xyz
  - a1
  - b2
  - c3

(3) Add one or more paragraph-wide side-notes

Lorem impsum und so weiter
:--- NOTE ---:
First side note
:--- NOTE ---:
Second side note

(4) Add a side note, which is linked to a word (foot-note-style)

Lorem ipsum [: NOTE | test :] und so weiter
:--- NOTE | test ---:
Here we go…

Markdown for text


# Markdown

This an *markdown* example with a bullet list:

* one
* two
* three

Objects are defined as yaml objects

Lorem ipsum dolor[: NOTE:test :] sit amet
:--- NOTE:test ---:
This is a test note

Or as stand-alone objects:

:------------------- CODE ----------------------:
class Test:
    def __init__(self, name): = name

External files

:--- ---:

:--- PLUGIN:file.yaml ---:

Marginal notes

Marginal notes can have multiple origins. They can be extracted from the markdown (e.g. footnotes or glossary entries) – syntax to be determined.

Marginal notes concerning the entire paragraph can be separated by three dashes. Example:

This is a paragraph
:--- NOTE ---:
First marginal note
:--- NOTE ---:
Second marginal note for the same paragraph


The Reference to a source in the text consists of a slug to the full reference and the text displayed.

Note: To display reference icons without inline citation just leave the last element blank.

This is text [: REFERENCE | AuthorCoauthor2020 | Author, F., Coauthor, S. 2016 :] that goes on.

And in references.yaml

    short: "Author, F., Coauthor, S. (2016). Some fancy title, 7(1)."
    long: ""Author, F., Coauthor, S. (2016). Some fancy title, 7(1). 2053951719897945."


:--- AUTHOR ---:
file: assets/images/authors/….png
name: Martha Mustermann
institution: Brand Inc.
linkedinName: sample
description: Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Chapter Header

# header


:----- CHAPTER_HEADER -----:
image: "assets/images/find-experts-at-kilta-com-k9pmyStHKXE-unsplash.jpg"
title: Introduction
subtitle: Design publications with a digital dissemination in mind