Markdown biçimlendirme¶

OpenClaw, giden Markdown’ı kanala özgü çıktıyı oluşturmadan önce paylaşılan bir ara temsile (IR) dönüştürerek biçimlendirir. IR, kaynak metni olduğu gibi korurken stil/bağlantı aralıklarını taşır; böylece parçalama ve render işlemleri kanallar arasında tutarlı kalır.

Hedefler¶

• Tutarlılık: tek ayrıştırma adımı, birden fazla render motoru.
• Güvenli parçalama: satır içi biçimlendirme parçalara bölünmeden önce metni ayırma.
• Kanala uyum: Markdown’ı yeniden ayrıştırmadan aynı IR’yi Slack mrkdwn, Telegram HTML ve Signal stil aralıklarına eşleme.

Pipeline¶

1. Markdown ayrıştırma -> IR - IR, düz metin ile stil aralıkları (kalın/italik/üstü çizili/kod/spoiler) ve bağlantı aralıklarından oluşur. - Ofsetler UTF-16 kod birimleridir; böylece Signal stil aralıkları API’siyle hizalanır. - Tablolar yalnızca bir kanal tablo dönüşümünü seçtiğinde ayrıştırılır.
2. IR’yi parçalama (önce biçim) - Parçalama, render’dan önce IR metni üzerinde yapılır. - Satır içi biçimlendirme parçalara bölünmez; aralıklar parça başına dilimlenir.
3. Kanal başına render - Slack: mrkdwn belirteçleri (kalın/italik/üstü çizili/kod), bağlantılar <url|label> olarak. - Telegram: HTML etiketleri (<b>, <i>, <s>, <code>, <pre><code>, <a href>). - Signal: düz metin + text-style aralıkları; etiket URL’den farklıysa bağlantılar label (url) olur.

IR örneği¶

Girdi Markdown:

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

IR (şematik):

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

Nerede kullanılır¶

• Slack, Telegram ve Signal giden adaptörleri IR’den render eder.
• Diğer kanallar (WhatsApp, iMessage, MS Teams, Discord) hâlâ düz metin veya kendi biçimlendirme kurallarını kullanır; Markdown tablo dönüşümü etkinse parçalamadan önce uygulanır.

Tablo işleme¶

Markdown tabloları sohbet istemcileri arasında tutarlı biçimde desteklenmez. Kanal (ve hesap) bazında dönüşümü denetlemek için markdown.tables kullanın.

• code: tabloları kod blokları olarak render et (çoğu kanal için varsayılan).
• bullets: her satırı madde işaretlerine dönüştür (Signal + WhatsApp için varsayılan).
• off: tablo ayrıştırma ve dönüşümünü devre dışı bırak; ham tablo metni olduğu gibi geçer.

Yapılandırma anahtarları:

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

Parçalama kuralları¶

• Parça sınırları kanal adaptörleri/yapılandırmadan gelir ve IR metnine uygulanır.
• Kod çitleri, kanalların doğru render etmesi için sonda bir yeni satırla tek blok olarak korunur.
• Liste önekleri ve alıntı önekleri IR metninin parçasıdır; bu nedenle parçalama öneklerin ortasında bölmez.
• Satır içi stiller (kalın/italik/üstü çizili/satır içi kod/spoiler) asla parçalara bölünmez; render motoru her parça içinde stilleri yeniden açar.

Kanallar arasında parçalama davranışı hakkında daha fazlası için Streaming + chunking bölümüne bakın.

Bağlantı politikası¶

• Slack: [label](url) -> <url|label>; yalın URL’ler yalın kalır. Çift bağlantılamayı önlemek için ayrıştırma sırasında otomatik bağlantılama kapalıdır.
• Telegram: [label](url) -> <a href="url">label</a> (HTML ayrıştırma modu).
• Signal: etiket URL ile eşleşmedikçe [label](url) -> label (url).

Spoiler’lar¶

Spoiler işaretleri (||spoiler||) yalnızca Signal için ayrıştırılır ve SPOILER stil aralıklarına eşlenir. Diğer kanallar bunları düz metin olarak ele alır.

Kanal biçimlendiricisi ekleme veya güncelleme¶

1. Tek seferde ayrıştırma: kanala uygun seçeneklerle (autolink, başlık stili, alıntı öneki) paylaşılan markdownToIR(...) yardımcısını kullanın.
2. Render: renderMarkdownWithMarkers(...) ve bir stil işaretleyici eşlemesi (veya Signal stil aralıkları) ile bir render motoru uygulayın.
3. Parçalama: render’dan önce chunkMarkdownIR(...) çağırın; her parçayı render edin.
4. Adaptörü bağlama: kanal giden adaptörünü yeni parçalayıcıyı ve render motorunu kullanacak şekilde güncelleyin.
5. Test: biçim testleri ekleyin veya güncelleyin; kanal parçalama kullanıyorsa bir giden teslimat testi ekleyin.

Common gotchas¶

• Slack köşeli parantez belirteçleri (<@U123>, <#C123>, <https://...>) korunmalıdır; ham HTML’yi güvenle kaçışlayın.
• Telegram HTML, bozuk işaretlemeyi önlemek için etiketler dışındaki metnin kaçışlanmasını gerektirir.
• Signal stil aralıkları UTF-16 ofsetlerine bağlıdır; kod noktası ofsetlerini kullanmayın.
• Çitli kod blokları için sondaki yeni satırları koruyun; kapanış işaretleri kendi satırlarında kalsın.