Markdown: Die universelle Sprache für die Kommunikation mit KI

Dieses Kapitel widmet sich einem leichteren Thema: etwas, das du wahrscheinlich jeden Tag verwendest, aber dessen Namen du vielleicht nicht kennst: Markdown.

Lass mich mit einer kühnen Behauptung beginnen:

Markdown ist das mit Abstand wichtigste Format, das du im KI-Zeitalter lernen solltest.

Warum? Lies weiter.

Was ist Markdown?

In einem Satz: Markdown ist eine Möglichkeit, Klartext mit durch Symbole gesteuerter Formatierung zu schreiben.

Klartext hat keine Formatierung – keine Überschriften, kein Fettdruck, keine Listen. Andererseits sind Rich-Text-Formate wie Word zu schwer: Sie benötigen spezielle Software zum Öffnen und erzeugen große Dateien.

Markdown ist der „genau richtige“ Mittelweg: Mit ein paar einfachen Symbolen kannst du Klartext formatieren.

Wenn du zum Beispiel schreibst:

# This is a heading
**This is bold**
- This is a list

Es wird als formatierte Überschrift, fetter Text und eine Liste angezeigt. So einfach ist das.

Warum du Markdown im KI-Zeitalter lernen musst

Grund 1: KI spricht Markdown

Hast du bemerkt, dass ChatGPT, Claude, Gemini und andere KIs in ihren Antworten automatisch fetten Text, Überschriften, Listen und Codeblöcke einfügen?

Das ist Markdown.

KI gibt keine Word-Dokumente oder PDFs aus. Ihr Standardausgabeformat ist Markdown. Jede Tabelle, jeder fette Text und jeder Codeblock, den du in diesem Tutorial siehst – alles Markdown.

Markdown nicht zu lernen ist, als würde man mit jemandem sprechen, aber die Wörter, die er schreibt, nicht verstehen. Kannst du trotzdem kommunizieren? Ja. Aber es ist weitaus weniger effizient.

Grund 2: Es ist überall

Markdown ist kein proprietäres Format für eine bestimmte Software; es ist ein universeller Standard. Die Anzahl der Tools, die Markdown unterstützen, ist unzählig:

Lerne ein Format, verwende es überall. Notizen, die du in Obsidian schreibst, behalten ihre Formatierung, wenn du sie nach GitHub kopierst. Gib sie einer KI, und sie versteht sie perfekt. Versuch das mal mit Word?

Grund 3: Unglaublich kleine Dateien

Das könnte dich überraschen: Für denselben Inhalt ist eine Markdown-Datei über 20-mal kleiner als eine Word-Datei.

Warum? Eine Word .docx-Datei ist im Wesentlichen ein komprimiertes Archiv von XML-Dateien, vollgestopft mit Stildefinitionen, Schriftinformationen und Dokumenteigenschaften. Selbst wenn du nur eine Zeile schreibst, ist die Datei dutzende KB groß.

Markdown ist Klartext. Die Dateigröße entspricht der Menge des geschriebenen Textes. Kein zusätzlicher Ballast.

Das ist besonders wichtig in KI-Szenarien. Wenn du ein Dokument zur Analyse an eine KI sendest, verbraucht Markdown weniger Tokens, verarbeitet schneller und kostet weniger. All diese XML-Tags und Stildefinitionen in einer Word-Datei werden als Tokens gezählt – verschwendet.

Grund 4: KI versteht Markdown besser

Viele Leute wissen das nicht.

Wenn du einer KI ein Word-Dokument gibst, muss sie es zuerst in Text umwandeln. Bei der Umwandlung kann Formatierung verloren gehen, Tabellen können verschoben werden und Bilder verschwinden.

Gib einer KI eine Markdown-Datei, und sie liest sie direkt. Markdown ist selbst Klartext – keine Umwandlung nötig, null Verlust.

Noch wichtiger: Markdown-Symbole (Überschriften mit #, Listen mit -, Code mit `) sind semantische Marker. Sie sagen der KI: „Das ist eine Überschrift“, „Das ist eine Liste“, „Das ist Code.“ Die KI muss nicht raten – sie weiß genau, was jeder Teil bedeutet.

Grund 5: Es ist das am einfachsten zu lernende Format

Du kannst 90 % von Markdown in 10 Minuten lernen. Die restlichen 10 % schlägst du bei Bedarf nach.

Vergleiche das mit dem Lernen von Word, LaTeX oder HTML. Markdown ist bei weitem das einfachste.

Markdown-Syntax: Die vollständige Anleitung

1. Überschriften

Verwende #, um Überschriften zu erstellen. Je mehr #, desto kleiner die Überschrift.

``` ``) inherently tell the AI, “this is a heading, this is a list, this is code.” The AI can understand your content structure more accurately.

Learn Markdown in 10 Minutes

There are only about a dozen Markdown syntax elements, and even fewer are needed for daily use. Below, they are ordered by frequency of use, starting with the most common.

1. Headings

Use # followed by a space. The number of # symbols indicates the heading level:

For daily use, up to level 3 is enough.

2. Bold and Italic

### 2. Textformatierung

Bold is used most often, italic occasionally.

3. Lists

Unordered lists use - or *:

### 3. Listen

Ungeordnete Listen:

Ordered lists use numbers followed by a period:

Geordnete Listen:

Lists can be nested by adding two spaces before the sub-item:

Verschachtelte Listen:

4. Code

Inline code uses single backticks:

### 4. Code

Inline-Code:

Result: Type claude --help to see help

Code blocks are wrapped with three backticks, and you can specify the language:

Codeblöcke (mit dreifachen Backticks):

```python
print("Hello World")

This is especially useful when communicating with AI. When sending code to an AI, wrap it in a code block so the AI can more accurately identify the code boundaries.

### 5. Links and Images

```

### 5. Links und Bilder

```

Images are just links with a `!` in front.

### 6. Blockquotes

Start with `>`:

```

### 6. Blockzitate

```

Result:

> This is a blockquote.
> It can span multiple lines.

### 7. Tables

```

### 7. Tabellen

```

Table syntax looks complex, but you don’t need to write it by hand. **Just ask the AI to generate it for you.** Say “organize this data into a table,” and the AI will output a Markdown table.

### 8. Horizontal Rules

Three or more `-` on a single line:

```

### 8. Horizontale Trennlinien

```

Used to separate different sections of an article.

### 9. Strikethrough

```

### 9. Durchgestrichen

```

Result: ~~Deleted text~~

---

## That’s Enough, Really

The 9 syntax elements above cover 99% of daily use cases.

**You don’t need to master Markdown.** Headings, bold, lists, and code blocks—master these four and you can handle most situations. Look up the rest when needed.

And Markdown has one advantage: **It’s okay if you can’t remember it all now; you’ll learn it by using it.** AI outputs Markdown, so as you read AI responses every day, you’ll naturally become familiar with these symbols.

---

## How to Use Markdown to Improve Communication with AI

After learning Markdown, here are a few tips to make your conversations with AI more effective:

**Tip 1: Use headings to structure your input**

```

---

## Wie man Markdown nutzt, um mit KI zu sprechen

### Tipp 1: Verwende Überschriften, um deine Eingabe zu strukturieren

Wenn du eine komplexe Anfrage hast, verwende Überschriften, um sie zu organisieren. Das hilft der KI, die Hierarchie und Beziehungen zwischen verschiedenen Teilen zu verstehen.

Beispiel:

```

Much better than a big block of text. With headings, the AI can more accurately understand the structure of your request.

**Tip 2: Wrap code in code blocks**

Don’t just paste code directly; wrap it in a code block:

```

### Tipp 2: Code in Codeblöcke setzen

Wenn du die KI bittest, Code zu analysieren oder zu debuggen, setze ihn immer in einen Codeblock. Das bewahrt die Formatierung und sagt der KI genau, was Code ist.

Beispiel:

```python
def hello()
    print("hello")
```

The AI can precisely distinguish between your words and the code.

Tip 3: Use lists to enumerate requirements

### Tipp 3: Verwende Listen für Anforderungen

Wenn du der KI eine Liste von Anforderungen gibst, verwende Aufzählungspunkte oder nummerierte Listen. Das macht jede Anforderung klar und deutlich.

Beispiel:

Much clearer than “Write me an article around 1000 words conversational style divided into three sections each with a subheading.”

Where to Practice?

You don’t need to find a specific place to practice. If you’re using Claude Code or Codex as you follow this tutorial, you’re using Markdown every day—you just didn’t know its name.

If you want a dedicated place to write Markdown, here are a few recommendations:

Beginners are recommended to use Obsidian. It’s free, easy to use, and works well with AI. If you want to dive deeper, check out the author’s other book, “Obsidian Handbook.”

Summary

What you learned today:

1. What Markdown is: A way to write plain text with formatting controlled by symbols, over 20 times lighter than Word
2. Why learn it in the AI era: AI outputs Markdown, it’s everywhere, files are small, AI understands it better
3. Core syntax (4 are enough): Headings #, bold **, lists -, code blocks ` ```

Tipp 4: Verwende Tabellen für strukturierte Daten

Wenn du möchtest, dass die KI strukturierte Daten verarbeitet, präsentiere sie in einer Tabelle. Das ist viel klarer, als sie in Prosa zu beschreiben.

Tipp 5: Verwende Blockzitate für Kontext

Wenn du Hintergrundinformationen gibst oder etwas zitierst, verwende Blockzitate. Das trennt den Kontext von deiner eigentlichen Anfrage.

Zusammenfassung

1. Was ist Markdown: Eine leichtgewichtige Auszeichnungssprache zur Formatierung von Klartext
2. Warum es lernen: KI spricht Markdown, es ist überall, Dateien sind winzig, KI versteht es besser und es ist leicht zu lernen
3. Grundlegende Syntax (5 Minuten zum Lernen): Überschriften, fett/kursiv, Listen, Codeblöcke
4. Vollständige Syntax (9 decken 99% ab): Plus Links, Bilder, Blockzitate, Tabellen, horizontale Trennlinien
5. Tipps für die Kommunikation mit KI: Verwende Überschriften zur Strukturierung, setze Code in Codeblöcke, verwende Listen für Anforderungen

Wichtige Erkenntnisse:

• Markdown ist die „Muttersprache“ der KI; es zu lernen bedeutet, effizient mit KI zu kommunizieren
• Lerne die Grundlagen in 10 Minuten, schlage den Rest bei Bedarf nach
• Kein bewusstes Üben nötig; du wirst es ganz natürlich beim Nutzen von KI lernen

Teil 2: API und Tokens: Der technische Kern