---
name: Telegram-Format MarkdownV2
description: Kais liest Telegram-Replies auf dem Handy und will Fettdruck, Code-Blöcke, klare Hierarchie. Ab 2026-05-08 gilt MarkdownV2 als Default-Modus für jede Telegram-Antwort.
type: feedback
originSessionId: ccbf4e5d-5b7f-4434-9a17-88c6a5def317
---
Telegram-Replies werden ab 2026-05-08 immer mit `format: "markdownv2"` gesendet, nicht mehr als Plain-Text.

**Why:** Kais hat am 08.05.2026 nach dem Hydration-Fix-Bericht ein Screenshot geschickt und gesagt: „Passe die Formatierung an, dass ich alles besser lesen kann. Fettgedruckt, Text zum Einfügen, Platzhalter, Schriftarten." Plain-Text mit Em-Dash-Bullets wird auf dem Handy zu einer einförmigen Wand — er sieht keine Struktur. Mit MarkdownV2 rendert Telegram Bold/Code/Pre-Blöcke als visuelle Anker.

Das ersetzt die alte Regel aus LRN-20260506-004 („KEIN Markdown, nur Klartext"). Die alte Regel galt nur weil das `reply`-Tool im Default Plain-Text sendet — der Workaround ist `format: "markdownv2"` in jedem Aufruf.

**How to apply:**

1. **Tool-Aufruf:** `mcp__plugin_telegram_telegram__reply` immer mit `format: "markdownv2"`. Nur in Notfällen (Escape-Probleme bei viel User-Input) auf `text` zurückfallen.

2. **Standard-Layout:**
   - Section-Header als `*Header*` (Bold).
   - Bullet-Points mit `•` (Unicode U+2022) statt `-` oder `—` — `•` braucht kein Escape, `-` und `—` schon.
   - Pfade, IDs, Commit-SHAs, Commands inline mit ``` `code` ```.
   - Mehrzeiliger Code/Output in ``` ```pre``` ``` Block (Tap-to-Copy in Telegram).
   - Zwischen Section-Headern eine Leerzeile.
   - Wichtigstes zuerst. Max 5 Bullets pro Section.

3. **Escape-Pflicht außerhalb von Code:** Diese Zeichen müssen mit `\` escaped werden: `_ * [ ] ( ) ~ \` > # + - = | { } . !`. Innerhalb von ``` ` ``` und ``` ``` ``` müssen nur `\` und `` ` `` selbst escaped werden.

4. **Praktische Konsequenzen:**
   - Punkt am Satzende → `\.`
   - Bindestrich (z.B. „Kadi-v2") → `Kadi\-v2` ODER innerhalb von Backticks: `` `Kadi-v2` ``.
   - Zahlen mit Punkt („Version 1.5.2") → `1\.5\.2` ODER `` `1.5.2` ``.
   - Ausrufezeichen → `\!` (selten gebraucht, Aria nutzt eh kaum welche).
   - Klammern in Erklärungen („Bug ist behoben (Commit abc)") → `Bug ist behoben \(Commit abc\)`.

5. **Was NICHT escapen:**
   - Inhalt zwischen ``` ` ``` oder ``` ``` ``` (außer Backtick und Backslash selbst).
   - URLs sind in MarkdownV2 OK ohne Escape, wenn sie nackt stehen — Telegram erkennt sie. Falls sie in einem `[Link](url)`-Konstrukt eingebaut sind, müssen die Zeichen in der URL escaped werden.

6. **Test-Pattern:** Wenn unsicher, einmal eine kleine Test-Nachricht mit den problematischen Zeichen senden bevor ein langer Bericht rausgeht. Telegram lehnt eine Nachricht mit MarkdownV2-Fehler komplett ab — entweder schlägt das `reply`-Tool fehl oder die Nachricht erscheint mit literal `\` Zeichen.

7. **Emojis als Anker bleiben erlaubt:** ✓ ⚠️ ❌ 🔴 🟢 🟠 🟡 — kein Escape nötig.

8. **Rohe URLs:** Weiterhin nackt einfügen, Telegram macht sie clickbar.

9. **Bei sehr langem Code-Block** mit Sprache: ``` ```bash\n…\n``` ```. Sprache wird auf dem Handy nicht highlighted, hilft aber bei Copy-in-IDE.

**Verbindungen:**
- Ersetzt: LRN-20260506-004 (Plain-Text-Default ist NICHT mehr aktuell, mit `format: "markdownv2"` rendert Telegram echtes Bold).
- Verwandt: feedback_no_secrets_via_telegram.md (Token-Inhalte gehören gar nicht erst nach Telegram, egal welches Format).
- Verwandt: feedback_telegram_reply_required.md (welches Tool, dieses Memory: welches Format).