Kapitel 2: Erste Schritte mit Markdown

In diesem Kapitel werden Sie Ihre erste Markdown-Datei erstellen und die grundlegende Syntax kennenlernen.

2.1 Eine Markdown-Datei erstellen

Markdown-Dateien haben die Endung .md oder .markdown.

Schritt 1: Editor wählen

Wir empfehlen Visual Studio Code (kostenlos):

1. Laden Sie VS Code von code.visualstudio.com herunter
2. Installieren Sie die Erweiterung "Markdown Preview Enhanced" für Live-Vorschau

Schritt 2: Datei erstellen

1. Erstellen Sie einen neuen Ordner (z.B. mein-markdown-projekt)
2. Erstellen Sie eine Datei namens README.md
3. Öffnen Sie die Datei in VS Code

Schritt 3: Live-Vorschau aktivieren

• Drücken Sie Strg + Umschalt + V (Windows/Linux) oder Cmd + Umschalt + V (Mac)
• Oder klicken Sie mit rechts auf die Datei und wählen Sie "Markdown: Open Preview"

2.2 Grundlegende Syntax

Hier sind die wichtigsten Markdown-Elemente:

Überschriften

# Überschrift 1 (größte)
## Überschrift 2
### Überschrift 3
#### Überschrift 4
##### Überschrift 5
###### Überschrift 6 (kleinste)

Tipp: Verwenden Sie # gefolgt von einem Leerzeichen.

Textformatierung

**Fetter Text**
*Kursiver Text*
***Fett und kursiv***
~~Durchgestrichener Text~~

Ergebnis:

• Fetter Text
• Kursiver Text
• Fett und kursiv
• Durchgestrichener Text

Listen

Ungeordnete Liste (Bullet Points):

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

Geordnete Liste (Nummerierung):

1. Erster Schritt
2. Zweiter Schritt
3. Dritter Schritt

Links

[Beschreibung](https://www.beispiel.de)

Beispiel:

Besuchen Sie [Google](https://www.google.com) für Suchen.

Bilder

![Alternativtext](bild.jpg)

Beispiel:

![Mein Hund](hund.jpg)

Code

Inline-Code:

Verwenden Sie den Befehl `npm install`, um Pakete zu installieren.

Code-Block:

```javascript
function hallo() {
  console.log("Hallo Welt!");
}
```

Zitate

> Das ist ein Zitat.
> Es kann über mehrere Zeilen gehen.

Horizontaler Trenner

---

2.3 Ihre erste Markdown-Datei

Erstellen Sie eine Datei uebung1.md mit folgendem Inhalt:

# Mein erster Blogpost

Willkommen auf meinem Blog! Hier teile ich meine Gedanken.

## Über mich

Ich bin ein **begeisterter Markdown-Nutzer**.

## Meine Hobbys

- Programmieren
- Schreiben
- Lesen

## Kontakt

Sie können mich unter [meine-email@beispiel.de](mailto:meine-email@beispiel.de) erreichen.

---

*Vielen Dank fürs Lesen!*

2.4 Markdown in VS Code

Nützliche Tastenkürzel

Aktion	Windows/Linux	Mac
Vorschau öffnen	Strg + Umschalt + V	Cmd + Umschalt + V
Vorschau zur Seite	Strg + K, V	Cmd + K, V
Fett	Strg + B	Cmd + B
Kursiv	Strg + I	Cmd + I

Empfohlene Erweiterungen

1. Markdown Preview Enhanced: Erweiterte Vorschau
2. Markdown Linter: Überprüft Syntaxfehler
3. Markdown All in One: Nützliche Werkzeuge (Inhaltsverzeichnis, etc.)

2.5 Best Practices

Do's ✅

• Verwenden Sie Leerzeilen zwischen Absätzen
• Nutzen Sie ## für Hauptabschnitte
• Verwenden Sie ### für Unterabschnitte
• Schreiben Sie aussagekräftige Alt-Texte für Bilder

Don'ts ❌

• Mischen Sie zu viele Überschriftenebenen
• Vergessen Sie Leerzeichen nach #
• Nutzen Sie zu komplexe Formatierungen
• Vernachlässigen Sie die Lesbarkeit im Quellcode

2.6 Häufige Fehler und Lösungen

Fehler 1: Überschrift funktioniert nicht

Problem: #Überschrift wird nicht als Überschrift erkannt. Lösung: Fügen Sie ein Leerzeichen nach # ein: # Überschrift.

Fehler 2: Liste wird nicht richtig angezeigt

Problem: Listenelemente erscheinen nicht als Liste. Lösung: Stellen Sie sicher, dass vor dem - oder der Zahl ein Leerzeichen steht.

Fehler 3: Link funktioniert nicht

Problem: Der Link wird als Text angezeigt. Lösung: Überprüfen Sie, ob Sie die Klammern richtig gesetzt haben: [Text](url).

2.7 Zusammenfassung

In diesem Kapitel haben Sie gelernt:

• ✅ Wie man eine Markdown-Datei erstellt
• ✅ Die grundlegende Syntax (Überschriften, Textformatierung, Listen, Links, Bilder)
• ✅ Wie man VS Code für Markdown nutzt
• ✅ Best Practices und häufige Fehler

Im nächsten Kapitel werden wir tiefer in die Formatierung eintauchen und lernen, wie man Tabellen, Syntaxhervorhebung und mehr verwendet!

---

Übung: Erstellen Sie eine profil.md Datei mit:

1. Ihrem Namen als Überschrift 1
2. Einem Abschnitt "Über mich" (Überschrift 2)
3. Einem Abschnitt "Fähigkeiten" mit einer Liste
4. Einem Link zu Ihrem GitHub-Profil oder einer anderen Webseite