# Markdownregeln und Tipps

In diesem Dokument werden einige Regeln und Tipps formuliert, die [die offizielle Markdown-Syntax](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) weiter ausformulieren.

## Zur Formatierung

### [Abbildungen](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet#lists)

- Abbildungen sollten voneinander und vom Text mit einer Leerzeile getrennt werden.
- Der Text in den `[` `]` ergibt für verschiedene Ausgabeformate später die Bildunterschrift.
- Die Nummerierung der Abbildungen wird später berechnet, daher sollte keine manuelle Nummerierung vorgenommen werden.
- Die Beeinflussung der Größe sowie die Position im Text wird zunächst von pandoc im Konvertierungsprozess entschieden. Es gibt Möglichkeiten, hierauf Einfluss zu nehmen, die an anderer Stelle erklärt werden (tbd).
- Abbildungen, die in einen Wikitext übernommen werden sollen, können per Drag & Drop in das Textfeld gezogen werden. Dabei wird das Bild hochgeladen und gleichzeitig die entsprechende Syntax automatisch erstellt. Soll später das Bild aktualisiert werden, kann es einfach erneut hochgeladen werden.

### [Aufzählungen](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet#lists)

- Aufzählungen müssen mit einer Leerzeile vorher und nachher abgetrennt werden.
- Die Aufzählungspunkte dürfen nicht mit einer Leerzeile voneinander abgetrennt werden.
- Das Aufzählungszeichen sollte ein - sein, ein * geht auch. Das Aufzählungszeichen muss als erstes Zeichen in einer Zeile stehen. Unteraufzählungspunkte müssen mit vier Leerzeichen eingerückt werden.

## Hilfe zu Markdown

Eine großartige Spielwiese mit ausführlichen Beispielen ist das Beispieldokument des Tools [dillinger.io](https://dillinger.io). Auf der linken Seite schreibt man und sieht auf der rechten sofort das Ergebnis.

## Lizenz

<a rel="license" href="http://creativecommons.org/licenses/by/4.0/"><img alt="Creative Commons Lizenzvertrag" style="border-width:0" src="https://i.creativecommons.org/l/by/4.0/88x31.png" /></a><br />Dieses Werk von Axel Dürkop und weiteren Beitragenden ist lizenziert unter einer <a rel="license" href="http://creativecommons.org/licenses/by/4.0/">Creative Commons Namensnennung 4.0 International Lizenz</a>.

###### tags: `hos` `modpub`