Markdown-Syntax Spickzettel: Von Anfänger bis Fortgeschritten

Einführung

Markdown ist eine leichtgewichtige Markup-Sprache, die es Ihnen ermöglicht, Dokumente in einem lesbaren und einfach zu schreibenden Klartextformat zu erstellen. Dieser Spickzettel deckt alle Markdown-Syntax von den Grundlagen bis zu fortgeschrittenen Funktionen ab und bietet praktische Beispiele. Ob Sie neu in Markdown sind oder spezifische Syntax nachschlagen möchten, dieser Leitfaden wird Ihnen helfen.

Grundlegende Syntax

Überschriften

Markdown unterstützt sechs Überschriftenebenen mit dem #-Symbol:

# Überschrift 1
## Überschrift 2
### Überschrift 3
#### Überschrift 4
##### Überschrift 5
###### Überschrift 6

Alternativ können Sie Unterstriche verwenden (nur für Ebene 1 und 2):

Überschrift 1
=============

Überschrift 2
-------------

Absätze und Zeilenumbrüche

Absätze werden durch Leerzeilen getrennt. Für einen Zeilenumbruch ohne neuen Absatz fügen Sie zwei Leerzeichen am Zeilenende hinzu.

Dies ist der erste Absatz.

Dies ist der zweite Absatz.

Dies ist eine Zeile  
Dies ist die nächste Zeile (beachten Sie die zwei Leerzeichen am Ende der vorherigen Zeile)

Textformatierung

Effekt	Syntax	Beispiel
Fett	`Text` oder `__Text__`	Fetter Text
Kursiv	`Text` oder `_Text_`	Kursiver Text
Fett und kursiv	`*Text*` oder `___Text___`	*Fetter und kursiver Text*
Durchgestrichen	`~~Text~~`	~~Durchgestrichener Text~~
Unterstrichen	`<u>Text</u>`	Unterstrichener Text

Listen

Ungeordnete Listen

Verwenden Sie -, + oder * für ungeordnete Listen:

- Element eins
- Element zwei
  - Unterelement 2.1
  - Unterelement 2.2
- Element drei

+ Sie können auch Plus verwenden
* Oder Sterne

Geordnete Listen

Verwenden Sie Zahlen mit Punkt für geordnete Listen:

1. Erstes Element
2. Zweites Element
   1. Unterelement 2.1
   2. Unterelement 2.2
3. Drittes Element

Aufgabenlisten

GitHub-Stil Aufgabenlisten:

- [x] Erledigte Aufgabe
- [ ] Offene Aufgabe
- [ ] Weitere offene Aufgabe

Links

Inline-Links

[Linktext](https://www.example.com)
[Link mit Titel](https://www.example.com "Link-Titel")

Referenz-Links

[Linktext][Referenz-ID]

[Referenz-ID]: https://www.example.com "Optionaler Titel"

Automatische Links

<https://www.example.com>
<[email protected]>

Bilder

![Alt-Text](Bild-URL)
![Bild mit Titel](Bild-URL "Bild-Titel")

Referenz-Stil Bilder:
![Alt-Text][Bild-Referenz]

[Bild-Referenz]: Bild-URL "Optionaler Titel"

Zitate

> Dies ist ein Zitat
> Das kann mehrere Zeilen haben
> 
> > Und sogar verschachtelte Zitate

Code

Inline-Code

Verwenden Sie `Backticks` für Inline-Code

Code-Blöcke

Verwenden Sie drei Backticks oder vier Leerzeichen Einrückung:

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

    Oder verwenden Sie Einrückung (vier Leerzeichen)
    function hello() {
        console.log("Hallo, Welt!");
    }

Trennlinien

Verwenden Sie drei oder mehr Bindestriche, Sterne oder Unterstriche:

---
***
___

Erweiterte Syntax

Tabellen

| Spalte1 | Spalte2 | Spalte3 |
|---------|---------|---------|
| Daten1  | Daten2  | Daten3  |
| Daten4  | Daten5  | Daten6  |

Ausrichtung:
| Linksbündig | Zentriert | Rechtsbündig |
|:------------|:---------:|-------------:|
| Links       | Mitte     | Rechts       |

Fußnoten

Dies ist ein Fußnoten-Beispiel[^1].

[^1]: Dies ist der Fußnoten-Inhalt.

Definitionslisten

Begriff 1
: Definition 1

Begriff 2
: Definition 2a
: Definition 2b

Abkürzungen

HTML ist eine Hypertext-Markup-Sprache.

*[HTML]: Hypertext Markup Language

GitHub Flavored Markdown (GFM)

Syntax-Hervorhebung

Geben Sie die Sprache in Code-Blöcken an:

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

```json
{
  "name": "beispiel",
  "version": "1.1.0"
}
```

Emojis

:smile: :heart: :thumbsup: :star:

Benutzer-Erwähnungen und Issue-Referenzen

@benutzername
#123 (Issue-Nummer)
organisation/repository#123

HTML-Unterstützung

Markdown unterstützt eingebettetes HTML:

<div style="color: red;">
  Dies ist roter Text
</div>

<details>
  <summary>Klicken zum Ausklappen</summary>
  Versteckter Inhalt
</details>

Escape-Zeichen

Verwenden Sie Backslash, um Sonderzeichen zu maskieren:

\* Nicht kursiv
\# Keine Überschrift
\[Kein Link\]

Zeichen, die maskiert werden müssen:

\ ` * _ {} [] () # + - . ! |

Best Practices

1. Konsistenz bewahren

Wählen Sie einen Überschriften-Stil und bleiben Sie dabei
Verwenden Sie einheitlich * oder - für Listen
Halten Sie Einrückung konsistent (normalerweise 2 oder 4 Leerzeichen)

2. Lesbarkeit priorisieren

Fügen Sie Leerzeilen vor und nach Überschriften hinzu
Trennen Sie Absätze mit Leerzeilen
Vermeiden Sie zu lange Zeilen (empfohlen: 80-100 Zeichen)

3. Semantische Verwendung

Verwenden Sie Überschriften hierarchisch, überspringen Sie keine Ebenen
Nutzen Sie angemessene Markup-Elemente (wie Listen, Zitate usw.)
Stellen Sie beschreibende Texte für Links und Bilder bereit

Häufige Fehler

1. Listenformat-Fehler

Falsch:
-Element eins (fehlendes Leerzeichen)
- Element zwei

Richtig:
- Element eins
- Element zwei

2. Link-Format-Fehler

Falsch:
(Linktext)[URL]

Richtig:
[Linktext](URL)

3. Code-Block-Einrückung

Falsch:
```
Code
```

Richtig:
```
Code
```

Tool-Tipps

Verwendung von MD-PDF-WORD

MD-PDF-WORD unterstützt perfekt alle diese Markdown-Syntax-Elemente und kann sie genau in PDF- und Word-Formate konvertieren:

Erhält alle Formatierungen
Rendert Tabellen korrekt
Unterstützt Code-Hervorhebung
Verarbeitet mehrsprachige Typografie

Tastenkürzel (häufige Editoren)

Funktion	Windows/Linux	Mac
Fett	Strg + B	Cmd + B
Kursiv	Strg + I	Cmd + I
Link	Strg + K	Cmd + K
Code	Strg + `	Cmd + `

Lernressourcen

Offizielle Spezifikation: Markdown Offizielle Dokumentation
GitHub-Leitfaden: GitHub Markdown Leitfaden
Interaktives Tutorial: Markdown Tutorial
Online-Vorschau: Verwenden Sie MD-PDF-WORDs Live-Vorschau-Funktion

Fazit

Die Beherrschung der Markdown-Syntax ermöglicht es Ihnen, formatierte Dokumente effizienter zu erstellen. Von grundlegender Textformatierung bis hin zu erweiterten Tabellen und Code-Blöcken bietet Markdown eine reichhaltige und dennoch einfache Syntax. In Kombination mit Tools wie MD-PDF-WORD können Sie Ihre Markdown-Dokumente einfach in professionelle PDF- oder Word-Formate konvertieren und verschiedene Dokumentenanforderungen erfüllen.

Denken Sie daran, dass die Kernphilosophie von Markdown darin besteht, Ihnen zu ermöglichen, sich auf den Inhalt zu konzentrieren, nicht auf die Formatierung. Wählen Sie die Syntax, die Sie benötigen, halten Sie es einfach und machen Sie Ihre Dokumente sowohl schön als auch wartbar.

Praktizieren Sie Markdown sofort

Verwenden Sie den MD-PDF-WORD Online-Editor, um diese Syntax zu üben

Editor öffnen Erweiterung installieren