Markdown: Einmal schreiben, überall veröffentlichen
Der einfachste Weg, Text zu formatieren, der auf GitHub, Notion, Blogs und fast überall sonst funktioniert.
Du musst Dokumentation schreiben. Oder eine README. Oder einen Blog-Post. Oder eine Slack-Nachricht mit Formatierung.
HTML ist übertrieben. Word-Dokumente funktionieren nicht überall. Reiner Text hat keine Formatierung.
Markdown sitzt im Sweet Spot. Einfache Syntax, lesbar als reiner Text, konvertiert bei Bedarf zu HTML.
Die Grundlagen
# Überschrift 1
## Überschrift 2
### Überschrift 3
**fett** und *kursiv*
- Aufzählungspunkt
- Weiterer Punkt
- Verschachtelter Punkt
1. Nummerierte Liste
2. Zweiter Punkt
[Linktext](https://example.com)
Das ist das meiste, was du brauchst.
Code-Formatierung
Inline-Code mit Backticks: console.log('hello')
Code-Blöcke mit dreifachen Backticks:
function hello() {
return 'world';
}
Gib die Sprache nach den öffnenden Backticks an für Syntax-Highlighting.
Tabellen
| Name | Rolle |
|-------|------------|
| Alice | Entwickler |
| Bob | Designer |
Tabellen sind fummelig zu tippen. Die meisten Editoren haben Shortcuts.
Blockzitate
> Das ist ein Zitat.
> Es kann mehrere Zeilen umfassen.
Verwende für Callouts, Zitate oder Hervorheben wichtiger Texte.
Warum Markdown funktioniert
Lesbarer Quelltext. Selbst ohne Rendering ist Markdown leicht zu lesen. **fett** ist offensichtlich fett.
Portabel. GitHub, Notion, Slack, Reddit, unzählige Static-Site-Generatoren. Einmal schreiben, überall einfügen.
Versionskontrolle-freundlich. Es ist reiner Text. Git-Diffs machen Sinn. Merges funktionieren.
Zukunftssicher. Kein proprietäres Format. Dein Inhalt ist für immer zugänglich.
Geschmacks-Unterschiede
GitHub Flavored Markdown (GFM) fügt Checkboxen, Tabellen und Syntax-Highlighting hinzu.
CommonMark ist die Standardisierungsbemühung. Die meisten Plattformen unterstützen es.
Einige Plattformen fügen Extras hinzu: Obsidian hat Wikilinks, Notion hat Datenbanken.
Für maximale Portabilität bleib bei grundlegender Syntax.
Häufige Fehler
Leerzeilen vergessen. Absätze brauchen Leerzeilen dazwischen. Ohne sie läuft alles zusammen.
Leerzeichen nach Überschriften. #Überschrift funktioniert nicht. # Überschrift schon. Beachte das Leerzeichen.
Kaputte Links. Das fehlende https:// lässt Links auf einigen Plattformen versagen.
Bilder ohne Alternativtext.  funktioniert, ist aber nicht barrierefrei. Füge Beschreibungen hinzu.
Schreib-Tipps
Verwende Überschriften für Struktur. Leser scannen vor dem Lesen.
Halte Absätze kurz. Leerraum hilft der Lesbarkeit.
Vorschau vor Veröffentlichung. Verschiedene Renderer handhaben Grenzfälle unterschiedlich.
Markdown entfernt Reibung vom Schreiben. Lerne die Grundlagen einmal, verwende sie überall. Die Einfachheit ist das Feature.