Was ist Markdown?

Eine Einführung in Markdown - die einfache Auszeichnungssprache für das Web.

Markdown: Einfach schreiben fürs Web

Markdown ist eine einfache Auszeichnungssprache, die es ermöglicht, formatierten Text mit minimalem Aufwand zu erstellen. Sie wurde 2004 von John Gruber und Aaron Swartz entwickelt und ist heute der Standard für viele Platformen wie GitHub, Reddit und natürlich auch Hugo.

Warum Markdown?

Vorteile gegenüber HTML

  • Lesbarkeit: Markdown-Dokumente sind auch ohne Rendering lesbar
  • Einfachheit: Keine komplexen Tags zu merken
  • Schnelligkeit: Deutlich schneller zu schreiben als HTML
  • Portabilität: Funktioniert überall

Beispiel-Vergleich

HTML:

<h1>Überschrift</h1>
<p>Ein Absatz mit <strong>fettem Text</strong> und <em>kursivem Text</em>.</p>
<ul>
    <li>Listelement 1</li>
    <li>Listelement 2</li>
</ul>

Markdown:

# Überschrift

Ein Absatz mit **fettem Text** und *kursivem Text*.

- Listelement 1
- Listelement 2

Markdown-Grundlagen

Überschriften

# Überschrift 1 (h1)
## Überschrift 2 (h2)
### Überschrift 3 (h3)
#### Überschrift 4 (h4)

Ergebnis:

Überschrift 1 (h1)

Überschrift 2 (h2)

Überschrift 3 (h3)

Überschrift 4 (h4)

Textformatierung

*Kursiv* oder _Kursiv_
**Fett** oder __Fett__
~~Durchgestrichen~~
`Code`

Ergebnis:

Kursiv oder Kursiv Fett oder Fett Durchgestrichen Code

Listen

Ungeordnete Listen

- Element 1
- Element 2
  - Unterelement 2.1
  - Unterelement 2.2
- Element 3

Geordnete Listen

1. Erstes Element
2. Zweites Element
3. Drittes Element
[Link-Text](https://beispiel.de)

![Alt-Text](/pfad/zum/bild.jpg)

Code-Blöcke

Einzeilig:

`code`

Mehrzeilig:

```python
def hallo_welt():
    print("Hallo, Welt!")

**Ergebnis:**

```python
def hallo_welt():
    print("Hallo, Welt!")

Tabellen

| Spalte 1 | Spalte 2 | Spalte 3 |
|---------|---------|---------|
| Zeile 1,1 | Zeile 1,2 | Zeile 1,3 |
| Zeile 2,1 | Zeile 2,2 | Zeile 2,3 |

Ergebnis:

Spalte 1Spalte 2Spalte 3
Zeile 1,1Zeile 1,2Zeile 1,3
Zeile 2,1Zeile 2,2Zeile 2,3

Zitate

> Dies ist ein Zitat.
> Es kann mehrere Zeilen umfassen.

Ergebnis:

Dies ist ein Zitat. Es kann mehrere Zeilen umfassen.

Horizontale Linien

---

oder

***

oder

___

Erweiterte Markdown-Features

Fußnoten

Hier ist ein Text mit einer Fußnote. [^1]

[^1]: Dies ist die Fußnote.

Aufgabenlisten

- [x] Aufgabe 1 erledigt
- [ ] Aufgabe 2 noch offen
- [ ] Aufgabe 3 noch offen

Ergebnis:

  • Aufgabe 1 erledigt
  • Aufgabe 2 noch offen
  • Aufgabe 3 noch offen

Emojis

Viele Markdown-Parser unterstützen Emoji-Shortcodes:

:smile: :heart: :rocket: :+1:

Tools für Markdown

Editoren

  • VS Code mit Markdown Preview
  • Typora - Minimalistischer Markdown-Editor
  • Obsidian - Für Notizen und Wissensmanagement
  • Notion - Unterstützt Markdown

Online-Tools

Tipps für effektives Markdown-Schreiben

  1. Überschriften-Struktur: Verwende eine klare Hierarchie (h1, h2, h3, …)
  2. Absätze: Trenne Absätze durch eine Leerzeile
  3. Bilder: Verwende immer Alt-Text für Barrierefreiheit
  4. Links: Wähle beschreibende Link-Texte
  5. Länge: Halte Zeilen unter 80 Zeichen für bessere Lesbarkeit

Fazit

Markdown ist eine mächtige, aber einfache Sprache, die das Schreiben fürs Web revolutioniert hat. Ob für Dokumentation, Blog-Artikel oder Notizen - Markdown macht das Formatieren von Text zum Kinderspiel.

Übung

Versuche doch mal, diesen Artikel in Markdown nachzubauen:

# Mein erster Markdown-Artikel

Dies ist ein *Einführungs*-Artikel.

## Was ich heute gelernt habe

- Markdown ist **einfach**
- Es gibt viele **Tools**
- Die Syntax ist **logisch**

> "Übung macht den Meister!"

[Mehr erfahren](https://markdownguide.org)

Frage: Welche Markdown-Features nutzt ihr am häufigsten? Schreibt es in die Kommentare!