Markdown-Formatierung

​

Pipeline

1. Markdown in IR analysieren (markdownToIR) – Klartext plus Stilspannen (fett, kursiv, durchgestrichen, Code, Codeblock, Spoiler, Blockzitat, Überschrift 1–6) und Link-Spannen. Offsets sind UTF-16-Codeeinheiten, sodass Signal-Stilbereiche direkt mit dessen API übereinstimmen. Tabellen werden nur analysiert, wenn für den Kanal ein Tabellenmodus aktiviert ist.
2. IR segmentieren (chunkMarkdownIR / renderMarkdownIRChunksWithinLimit)
   • Die Aufteilung erfolgt vor dem Rendern anhand des IR-Texts, sodass Inline-Stile und Links für jedes Segment zugeschnitten werden, statt an einer Grenze unterbrochen zu werden.
3. Pro Kanal rendern (renderMarkdownWithMarkers) – eine Zuordnung von Stilmarkierungen wandelt Spannen in das native Markup des Kanals um.

​

IR-Beispiel

Hallo **Welt** – siehe [Dokumentation](https://docs.openclaw.ai).

{
  "text": "Hallo Welt – siehe Dokumentation.",
  "styles": [{ "start": 6, "end": 10, "style": "bold" }],
  "links": [{ "start": 19, "end": 32, "href": "https://docs.openclaw.ai" }]
}

​

Tabellenverarbeitung

channels:
  discord:
    markdown:
      tables: code
    accounts:
      work:
        markdown:
          tables: off

​

Segmentierungsregeln

• Segmentgrenzen stammen aus den Kanaladaptern bzw. der Konfiguration und gelten für IR-Text, nicht für die gerenderte Ausgabe.
• Codeblöcke mit Fences werden als einzelner Block mit abschließendem Zeilenumbruch beibehalten, damit Kanäle die schließende Fence korrekt rendern.
• Listen- und Blockzitatpräfixe sind Teil des IR-Texts, sodass die Segmentierung niemals innerhalb eines Präfixes trennt.
• Inline-Stile werden niemals über mehrere Segmente getrennt; der Renderer öffnet einen offenen Stil am Anfang des nächsten Segments erneut.

​

Link-Richtlinie

• Slack: [label](url) -> <url|label>; reine URLs bleiben unverändert.
• Telegram: [label](url) -> <a href="url">label</a> (HTML-Analysemodus).
• Signal: [label](url) -> label (url), sofern die Beschriftung nicht bereits mit der URL übereinstimmt.

​

Spoiler

​

Kanalformatierer hinzufügen oder aktualisieren

1. Einmal analysieren mit markdownToIR(...) und dabei kanalgeeignete Optionen übergeben (autolink, headingStyle, blockquotePrefix, tableMode).
2. Rendern mit renderMarkdownWithMarkers(...) und einer Zuordnung von Stilmarkierungen (oder benutzerdefinierter Stilbereichslogik für Transporte wie Signal).
3. Segmentieren mit chunkMarkdownIR(...) oder renderMarkdownIRChunksWithinLimit(...), bevor jedes Segment gerendert wird.
4. Adapter anbinden, sodass der neue Segmentierer und Renderer über den ausgehenden Sendepfad aufgerufen werden.
5. Testen mit Formatierungstests sowie einem Test der ausgehenden Zustellung, wenn der Kanal segmentiert.

​

Häufige Fallstricke

• Slack-Tokens in spitzen Klammern (<@U123>, <#C123>, <https://...>) müssen die Maskierung überstehen; unverarbeitetes HTML muss weiterhin sicher maskiert werden.
• Telegram-HTML erfordert die Maskierung von Text außerhalb der Tags, um fehlerhaftes Markup zu vermeiden.
• Signal-Stilbereiche verwenden UTF-16-Offsets, nicht Codepunkt-Offsets.
• Behalten Sie abschließende Zeilenumbrüche bei Codeblöcken mit Fences bei, damit die schließende Markierung in einer eigenen Zeile steht.

​

Verwandte Themen