Formatowanie Markdown

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Cele

• Spójność: jeden etap parsowania, wiele rendererów.
• Bezpieczne dzielenie na fragmenty: dziel tekst przed renderowaniem, aby formatowanie inline nigdy nie urywało się między fragmentami.
• Dopasowanie do kanału: mapuj ten sam IR na Slack mrkdwn, HTML Telegram oraz zakresy stylów Signal bez ponownego parsowania Markdown.

​

Pipeline

1. Parsuj Markdown -> IR
   • IR to zwykły tekst oraz zakresy stylów (bold/italic/strike/code/spoiler) i zakresy linków.
   • Przesunięcia są jednostkami kodu UTF-16, aby zakresy stylów Signal były zgodne z jego API.
   • Tabele są parsowane tylko wtedy, gdy kanał włącza konwersję tabel.
2. Dziel IR na fragmenty (najpierw format)
   • Dzielenie odbywa się na tekście IR przed renderowaniem.
   • Formatowanie inline nie jest dzielone między fragmentami; zakresy są przycinane dla każdego fragmentu.
3. Renderuj dla każdego kanału
   • Slack: tokeny mrkdwn (bold/italic/strike/code), linki jako <url|label>.
   • Telegram: tagi HTML (<b>, <i>, <s>, <code>, <pre><code>, <a href>).
   • Signal: zwykły tekst + zakresy text-style; linki stają się label (url), gdy etykieta się różni.

​

Przykład IR

Hello **world** - see [docs](https://docs.openclaw.ai).

{
  "text": "Hello world - see docs.",
  "styles": [{ "start": 6, "end": 11, "style": "bold" }],
  "links": [{ "start": 19, "end": 23, "href": "https://docs.openclaw.ai" }]
}

​

Gdzie jest używany

• Adaptery wychodzące Slack, Telegram i Signal renderują z IR.
• Inne kanały (WhatsApp, iMessage, Microsoft Teams, Discord) nadal używają zwykłego tekstu lub własnych reguł formatowania, z konwersją tabel Markdown stosowaną przed dzieleniem na fragmenty, gdy jest włączona.

​

Obsługa tabel

• code: renderuj tabele jako bloki kodu (domyślnie dla większości kanałów).
• bullets: konwertuj każdy wiersz na punkty listy (domyślnie dla Matrix, Signal i WhatsApp).
• off: wyłącz parsowanie i konwersję tabel; surowy tekst tabeli przechodzi dalej.

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

​

Reguły dzielenia na fragmenty

• Limity fragmentów pochodzą z adapterów/konfiguracji kanałów i są stosowane do tekstu IR.
• Ogrodzenia kodu są zachowywane jako pojedynczy blok z końcowym znakiem nowego wiersza, aby kanały renderowały je poprawnie.
• Prefiksy list i prefiksy cytatów blokowych są częścią tekstu IR, więc dzielenie na fragmenty nie rozdziela tekstu w środku prefiksu.
• Style inline (bold/italic/strike/inline-code/spoiler) nigdy nie są dzielone między fragmentami; renderer ponownie otwiera style wewnątrz każdego fragmentu.

​

Polityka linków

• Slack: [label](url) -> <url|label>; gołe adresy URL pozostają gołe. Autolink jest wyłączony podczas parsowania, aby uniknąć podwójnego linkowania.
• Telegram: [label](url) -> <a href="url">label</a> (tryb parsowania HTML).
• Signal: [label](url) -> label (url), chyba że etykieta pasuje do URL.

​

Spoilery

​

Jak dodać lub zaktualizować formatter kanału

1. Parsuj raz: użyj współdzielonego helpera markdownToIR(...) z opcjami odpowiednimi dla kanału (autolink, styl nagłówków, prefiks cytatu blokowego).
2. Renderuj: zaimplementuj renderer z renderMarkdownWithMarkers(...) i mapą znaczników stylu (lub zakresami stylów Signal).
3. Dziel na fragmenty: wywołaj chunkMarkdownIR(...) przed renderowaniem; renderuj każdy fragment.
4. Podłącz adapter: zaktualizuj adapter wychodzący kanału, aby używał nowego mechanizmu dzielenia na fragmenty i renderera.
5. Testuj: dodaj lub zaktualizuj testy formatowania oraz test dostarczania wychodzącego, jeśli kanał używa dzielenia na fragmenty.

​

Częste pułapki

• Tokeny Slack w nawiasach kątowych (<@U123>, <#C123>, <https://...>) muszą być zachowane; bezpiecznie escapuj surowy HTML.
• HTML Telegram wymaga escapowania tekstu poza tagami, aby uniknąć uszkodzonego znacznikowania.
• Zakresy stylów Signal zależą od przesunięć UTF-16; nie używaj przesunięć punktów kodowych.
• Zachowuj końcowe znaki nowego wiersza dla ogrodzonych bloków kodu, aby znaczniki zamykające trafiały do własnego wiersza.

​

Powiązane