> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Markdown-formatering

# Markdown-formatering

OpenClaw-format utgående Markdown genom att konvertera det till en delad mellanliggande
representation (IR) före rendering av kanalspecifik utgång. IR håller
källtext intakt medan du bär stil/länk spänner över så att chunking och rendering kan
vara konsekvent över alla kanaler.

## Mål

* **Konsekvens:** ett parssteg, flera renderare.
* **Säker chunking:** dela text före rendering så att inline-formatering aldrig bryts mellan chunkar.
* **Kanalanpassning:** mappa samma IR till Slack mrkdwn, Telegram HTML och Signal-stilintervall utan att parsa Markdown på nytt.

## Pipeline

1. **Parsa Markdown -> IR**
   * IR är vanlig text plus stilspann (fet/kursiv/genomstruken/kod/spoiler) och länkspann.
   * Offsetar är UTF-16-kodenheter så att Signal-stilintervall linjerar med dess API.
   * Tabeller parsas endast när en kanal väljer att delta i tabellkonvertering.
2. **Chunka IR (format-först)**
   * Chunking sker på IR-texten före rendering.
   * Inline-formatering delas inte mellan chunkar; spann skärs per chunk.
3. **Rendera per kanal**
   * **Slack:** mrkdwn-tokens (fet/kursiv/genomstruken/kod), länkar som `<url|label>`.
   * **Telegram:** HTML-taggar (`<b>`, `<i>`, `<s>`, `<code>`, `<pre><code>`, `<a href>`).
   * **Signal:** vanlig text + `text-style`-intervall; länkar blir `label (url)` när etiketten skiljer sig.

## IR-exempel

Indata Markdown:

```markdown theme={"theme":{"light":"min-light","dark":"min-dark"}}
Hello **world** — see [docs](https://docs.openclaw.ai).
```

IR (schematiskt):

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "text": "Hello world — see docs.",
  "styles": [{ "start": 6, "end": 11, "style": "bold" }],
  "links": [{ "start": 19, "end": 23, "href": "https://docs.openclaw.ai" }]
}
```

## Var den används

* Utgående adaptrar för Slack, Telegram och Signal renderar från IR.
* Andra kanaler (WhatsApp, iMessage, MS Teams, Discord) använder fortfarande vanlig text eller sina egna formateringsregler, med Markdown-tabellkonvertering tillämpad före chunking när den är aktiverad.

## Tabellhantering

Markdown-tabeller stöds inte konsekvent över chattklienter. Använd
`markdown.tables` för att kontrollera konvertering per kanal (och per konto).

* `code`: rendera tabeller som kodblock (standard för de flesta kanaler).
* `bullets`: konvertera varje rad till punktlistor (standard för Signal + WhatsApp).
* `off`: inaktivera tabellparsning och konvertering; rå tabelltext passerar igenom.

Konfig-nycklar:

```yaml theme={"theme":{"light":"min-light","dark":"min-dark"}}
channels:
  discord:
    markdown:
      tables: code
    accounts:
      work:
        markdown:
          tables: off
```

## Chunking-regler

* Chunkgränser kommer från kanaladaptrar/konfig och tillämpas på IR-texten.
* Kodstaket bevaras som ett enda block med en avslutande nyrad så att kanaler renderar dem korrekt.
* Listprefix och blockquote-prefix är en del av IR-texten, så chunking delar inte mitt i ett prefix.
* Inline-stilar (fet/kursiv/genomstruken/inline-kod/spoiler) delas aldrig mellan chunkar; renderaren öppnar stilar igen inuti varje chunk.

Om du behöver mer om chunking-beteende mellan kanaler, se
[Streaming + chunking](/concepts/streaming).

## Länkpolicy

* **Slack:** `[label](url)` -> `<url|label>`; nakna webbadresser förblir bla. Autolink
  är inaktiverat under tolk för att undvika dubbelkoppling.
* **Telegram:** `[label](url)` -> `<a href="url">label</a>` (HTML-parsläge).
* **Signal:** `[label](url)` -> `label (url)` om inte etiketten matchar URL:en.

## Spoilers

Spoilermarkörer (`<unk> spoiler<unk> `) tolkas endast för Signal, där de kartlägger
SPOILER stilintervall. Andra kanaler behandlar dem som ren text.

## Hur man lägger till eller uppdaterar en kanalformatterare

1. **Parsa en gång:** använd den delade hjälparen `markdownToIR(...)` med kanal-lämpliga alternativ (autolänkning, rubrikstil, blockquote-prefix).
2. **Rendera:** implementera en renderare med `renderMarkdownWithMarkers(...)` och en stilmärkesmapp (eller Signal-stilintervall).
3. **Chunka:** anropa `chunkMarkdownIR(...)` före rendering; rendera varje chunk.
4. **Koppla adapter:** uppdatera den utgående kanaladaptern för att använda den nya chunkern och renderaren.
5. **Testa:** lägg till eller uppdatera format-tester och ett utgående leveranstest om kanalen använder chunking.

## Vanliga fallgropar

* Slack-vinkelparentes-tokens (`<@U123>`, `<#C123>`, `<https://...>`) måste bevaras; escapa rå HTML säkert.
* Telegram HTML kräver escapning av text utanför taggar för att undvika trasig markup.
* Signal-stilintervall beror på UTF-16-offsetar; använd inte kodpunkts-offsetar.
* Bevara avslutande nyrader för inhägnade kodblock så att stängningsmarkörer hamnar på sin egen rad.