Markdown 2 Oxid Doku

Auf dieser Seite finden Sie eine Übersicht der mit Markdown zur Verfügung stehenden, gängigsten Formatierungsmöglichkeiten.
Sie werden feststellen, dass Markdown an vielen Stellen sehr intuitiv funktioniert.
Eine Überschrift mit === zu unterstreichen oder Listenpunkte mit - oder mit 1. zu beginnen, erfordert keine Umstellung beim Schreiben von Texten.

Im Folgendem wird in jedem Unterpunkt zunächst die Markdown-Syntax in einem Codeblock dargestellt, gefolgt vom fertig konvertierten Ergebnis.

Überschriften

Es gibt 3 Möglichkeiten, die letztendlich zum selben Resultat führen.

Die erste Option steht für Überschriften der Ebenen H1 und H2 zur Verfügung.
Die Überschrift wird durch Unterstreichen hervorgehoben.
Die Anzahl der = bzw. - kann frei gewählt werden.

Überschrift H1      
=================================  
Überschrift H2     
---------------

Die folgende Option ist vermutlich die Gängigste und steht für H1 bis H6 zur Verfügung.

# Überschrift H1 
## Überschrift H2 
### Überschrift H3  
#### Überschrift H4 
##### Überschrift H5 
###### Überschrift H6

Aus optischen Gründen können die # auch nach dem Text in beliebiger Anzahl eingefügt werden.

# Überschrift H1 #########    
## Überschrift H2 ########  
### Überschrift H3 #######   
#### Überschrift H4 ######  
##### Überschrift H5 #####  
###### Überschrift H6 ####

Überschrift H1

Überschrift H2

Überschrift H3

Überschrift H4

Überschrift H5
Überschrift H6

Text hervorheben

Hierfür wird das Wort oder die betreffende Textstelle von Zeichen umrahmt.

Zwischen den Umrahmungszeichen und dem zu betonenden Text darf sich kein Leerzeichen befinden.

*kursiver Text* oder _kursiver Text_

**fetter Text** oder __fetter Text__

`Code`

    4 Leerzeichen am Zeilenanfang erzeugen einen Codeblock wie diesen

kursiver Text oder kursiver Text

fetter Text oder fetter Text

Code

4 Leerzeichen am Zeilenanfang erzeugen einen Codeblock wie diesen

Zitate

> am Zeilenanfang erzeugt ein Zitat

am Zeilenanfang erzeugt ein Zitat

Listen

Ein Listenpunkt kann entweder mit einem *, einen + oder einen -, jeweils gefolgt von einem Leerzeichen beginnen.

- Listenpunkt A
* Listenpunkt B
    + Unterlistenpunkt A mit 4 Leerzeichen eingerückt
    - Unterlistenpunkt B mit 4 Leerzeichen eingerückt
- Listenpunkt C

Nummerierte Listen beginnen mit einer Zahl gefolgt von einem . und einem Leerzeichen.

1. Nummerierte Liste A
2. Nummerierte Liste B
  • Listenpunkt A
  • Listenpunkt B
    • Unterlistenpunkt A mit 4 Leerzeichen eingerückt
    • Unterlistenpunkt B mit 4 Leerzeichen eingerückt
  • Listenpunkt C
  1. Nummerierte Liste A
  2. Nummerierte Liste B

Zeilenumbruch, Absatz, Linien

2 (oder mehr) Leerzeichen nach einem Satz erzeugen einen Zeilenumbruch (neue Zeile, wie <br /> )  

Eine Leerzeile erzeugt einen Absatz ( <p></p> )

___ oder --- oder *** (je 3 oder mehr) werden zu horizontalen Linien

Links, Bilder

Ein zu verlinktendes Wort (bzw. Text) wird in [ ] geschrieben. Der Link folgt dann in ( ).
Bei Bildern verhält es sich ähnlich, nur ein ! zu Beginn sorgt dafür, dass letzendlich nicht wie beim ersten Beispiel das Wort in den [ ] verlinkt, sondern eine Bilddatei eingefügt wird.
Der Alternative Text (Alttext) bei Bildern ist übrigens der Text, welcher angezeigt wird, wenn das Bild nicht dargestellt werden kann oder soll.

Aufgrund dieser Darstellung von Links und Bildern wird auch hierbei das Ziel von Markdown erreicht, im Klartext lesbar zu sein.

[Beschriftung](https://ecomstyle.de/) hier wird das Wort Beschriftung verlinkt

![Alttext](https://ecomstyle.de/pfad/bild.png) fügt ein Bild ein    

<https://ecomstyle.de/> wird zu einem klickbaren Link

Beschriftung hier wird das Wort Beschriftung verlinkt

Alttext fügt ein Bild ein

https://ecomstyle.de/ wird zu einem klickbaren Link

Tabellen

Der Tabellenkopf wird durch - vom Tabellenkörper getrennt.
Die : bestimmen die Ausrichtung des Spalteninhaltes.
Ohne : wird der Inhalt nicht ausgerichtet, also links platziert.
In der mittleren Spalte mit beidseitigen : wird der Inhalt zentriert, in der rechten Spalte mit einem : rechts wird der Inhalt rechts ausgerichtet.

Das erste Beispiel zeigt eine optisch schön gestaltete Tabelle:

| Header 1 | Header 2 | Header 3 |
| -------- |:--------:| --------:|
| A1       | A2       | A3       |
| B1       | B2       | B3       |
| C1       | C3       | C3       |

Schneller zu Tippen ist diese kurze Alternative, bei gleichem Ergebnis:

Header 1 | Header 2 | Header 3
- |:-:| -:
A1 | A2 | A3
B1 | B2 | B3
C1 | C3 | C3
Header 1 Header 2 Header 3
A1 A2 A3
B1 B2 B3
C1 C3 C3