
Unser Projekt ist auch auf die Mithilfe anderer angewiesen.
Mehr Informationen über die Mitarbeit an unserem Projekt findest du hier:
Übersicht
1. Einleitung
Die sich im Aufbau befindlichen Seiten zeigen dir bereits Beispielformatierungen und Stilvorlagen an, um dir die verschiedenen Gestaltungsmöglichkeiten zu veranschaulichen. Der Sourcecode der Vorlagen ist für registrierte Nutzer unseres Onedev-Servers unter collections/06-community/howto/template abrufbar.
2. Markdown-Syntax
2.1 Textstile
2.1.1 Kursiv
one thing has emphasis
one _thing_ has *em*phasis
2.1.2 Fett
two things are bold
two __things__ are **bold**
2.1.3 Codeblock
Nach drei Akzentzeichen kann die Syntaxsprache mit angegeben werden. Dies sorgt in den meisten Fällen für die Programmiersprache passende farbliche Hervorhebung.
print("this is a code block")
```python \ print(“this is a code block”) \ ```
Auch Tabulatoreinrückungen erzeugen einen Codeblock:
(Tabulator) this is also a code block
this is also a code block
2.1.4 Text einfärben
A blue paragraph.
{: .blue}
<style>
.blue {
color: blue
}
</style>
A blue paragraph.
{: .blue}
2.1.5 Bilder einbinden
Das Einbinden von Bildern oder Fotos wird im Frontmatter-Bereich der Markdowndateien festgelegt (siehe “Blogbeitrag erstellen” ). In seltenen Fällen kann es notwendig sein, die Bildeinbindung per Markdown-Auszeichnung zu verwenden.
Text hier einsetzen
Es ist zu beachten, dass diese Bilder nur linksbündig im Layout dargestellt werden.
2.2 Überschriften
HTML:

Markdown-Formatierungen:
# h1-Überschrift
## h2-Überschrift
### h3-Überschrift
#### h4-Überschrift
##### h5-Überschrift
###### h6-Überschrift
2.3 Links
2.3.1 Interne Links:
Diese Verknüpfungsform kann innerhalb des Webseitenprojekts ds-jetzt verwendet werden.
Beispiel: Blogbeitrag erstellen
Beispiel: [Blogbeitrag erstellen](/howto/@pub/blogbeitrag-erstellen.html)
2.3.2 Inline oder Referenzlinks:
Hier sind zwei Beispiele wie Verknüpfungen mit anderen Seiten hergestellt werden können.
Hier sind zwei [Beispiele](https://example.com), wie [Verknüpfungen][1] mit anderen Seiten hergestellt werden können.
[1]: https://slashdot.org
2.3.3 Link öffnet in neuem Browsertab:
Empfohlen {:target="_blank"} für externe Links, die diese Webseite verlassen.
[Empfohlen](https://example.com){:target="_blank"} für externe Links, die diese Webseite verlässt.
2.3.4 Ankerlinks:
Die Ziellinks werden aus allen h1 bis h6 Markdown-Überschriften automatisch generiert. Sie werden mit einem Rautezeichen eingeleitet.

# 1. Markdown-Syntax
### 1.1 Textstile
#### __1.1.1 Kursiv__
#### __1.1.2 Fett__
#### __1.1.3 Codeblock__
#### __1.1.4 Text einfärben__
### 1.2 Überschriften
2.4 Videos einbinden
<div class="youtube-video-container">
<iframe
width="560"
height="315"
src="https://www.youtube.com/embed/NoFLJLJ7abE"
frameborder="0"
allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture"
allowfullscreen
></iframe>
</div>
1.5 Fußnoten
1.5.1 Fußnoten mit automatischer Nummerierung
hello{% fn %} world{% fn %}
{% footnotes %}
{% fnbody %} salut {% endfnbody %} {% fnbody %} monde {% endfnbody %} {% endfootnotes %}
Innerhalb des Blogartikel:
Als Eintrag in der letzten Markdowndatei im Artikelordner, z.B. __"090_fussnoten.md"__. Fußnoten werden hiermit am Ende des Blogartikels angezeigt:
2.5.2 Fußnoten mit benutzerdefinierter Nummerierung
hello{% fn 3 %} world{% fn 5 %}
{% footnotes %}
{% fnbody 3%} salut {% endfnbody %} {% fnbody 5 %} monde {% endfnbody %} {% endfootnotes %}
Blogartikel:
Fußnoten:
3. Layout-Stilvorlagen
Die Verwendung der Layout-Stilvorlagen wird im Beitrag “Blogbeitrag erstellen” erklärt.
3.1 style: default
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. \
Frontmatter der Vorlagendatei: /collections/_howto/template/100_style_default.md {% highlight markdown %}— style: default —{% endhighlight " %}

3.2 img_before: bilddatei.png
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. \
Frontmatter der Vorlagendatei: /collections/_howto/template/110_img_before.md {% highlight markdown %}— style: default img_before: “openswissknife.png” img_before_caption: “Optional hier eine Bildbeschreibung einfügen” —{% endhighlight " %}
3.3 img_after: bilddatei.png
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. \
Frontmatter der Vorlagendatei: /collections/_howto/template/120_img_after.md {% highlight markdown %}— style: default img_after: “image02.png” img_after_caption: “Optional hier eine Bildbeschreibung einfügen” —{% endhighlight " %}

3.4 img_float_left: bilddatei.png

3.5 img_float_right: bilddatei.png

4. Weiterführende Informationen
4.1 Weblinks
- ds-jetzt - Blogbeitrag erstellen
- Gitlab - Markdown Kramdown Tips & Tricks {:target="_blank"}
- kramdown gettalong - Syntax {:target="_blank"}