Markdown biçimlendirmesi

​

İşlem hattı

1. Markdown’ı IR’ye ayrıştırın (markdownToIR) - düz metnin yanı sıra stil aralıkları (kalın, italik, üstü çizili, kod, kod bloğu, spoiler, blok alıntı, 1-6. düzey başlık) ve bağlantı aralıkları. Ofsetler UTF-16 kod birimleridir; böylece Signal stil aralıkları doğrudan API’siyle hizalanır. Tablolar yalnızca kanal bir tablo modunu etkinleştirdiğinde ayrıştırılır.
2. IR’yi parçalara ayırın (chunkMarkdownIR / renderMarkdownIRChunksWithinLimit)
   • bölme, oluşturmadan önce IR metninde gerçekleşir; böylece satır içi stiller ve bağlantılar bir sınırı aşarak bozulmak yerine her parçaya göre dilimlenir.
3. Kanal başına oluşturun (renderMarkdownWithMarkers) - bir stil işareti eşlemesi aralıkları kanalın yerel işaretlemesine dönüştürür.

​

IR örneği

Merhaba **dünya** - [belgelere](https://docs.openclaw.ai) bakın.

{
  "text": "Merhaba dünya - belgelere bakın.",
  "styles": [{ "start": 8, "end": 13, "style": "bold" }],
  "links": [{ "start": 16, "end": 25, "href": "https://docs.openclaw.ai" }]
}

​

Tablo işleme

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

​

Parçalama kuralları

• Parça sınırları kanal bağdaştırıcılarından/yapılandırmasından gelir ve oluşturulan çıktıya değil IR metnine uygulanır.
• Çitli kod blokları, kanalların kapanış çitini doğru oluşturabilmesi için sonunda yeni satır bulunan tek bir blok olarak korunur.
• Liste ve blok alıntı önekleri IR metninin parçasıdır; bu nedenle parçalama hiçbir zaman önekin ortasından bölmez.
• Satır içi stiller hiçbir zaman parçalar arasında bölünmez; oluşturucu, açık bir stili sonraki parçanın başında yeniden açar.

​

Bağlantı politikası

• Slack: [label](url) -> <url|label>; çıplak URL’ler çıplak kalır.
• Telegram: [label](url) -> <a href="url">label</a> (HTML ayrıştırma modu).
• Signal: Etiket zaten URL ile eşleşmiyorsa [label](url) -> label (url).

​

Spoiler’lar

​

Kanal biçimlendiricisi ekleme veya güncelleme

1. Kanala uygun seçenekleri (autolink, headingStyle, blockquotePrefix, tableMode) ileterek markdownToIR(...) ile bir kez ayrıştırın.
2. Bir stil işareti eşlemesiyle (veya Signal gibi aktarımlar için özel stil aralığı mantığıyla) renderMarkdownWithMarkers(...) kullanarak oluşturun.
3. Her parçayı oluşturmadan önce chunkMarkdownIR(...) veya renderMarkdownIRChunksWithinLimit(...) ile parçalara ayırın.
4. Giden gönderim yolundan yeni parçalayıcıyı ve oluşturucuyu çağırması için bağdaştırıcıyı bağlayın.
5. Biçim testleriyle ve kanal parçalara ayırıyorsa bir giden teslim testiyle test edin.

​

Yaygın sorunlar

• Slack açılı ayraç belirteçleri (<@U123>, <#C123>, <https://...>) kaçış işleminden sağ çıkmalıdır; ham HTML’nin yine de güvenli biçimde kaçışlanması gerekir.
• Telegram HTML’sinde bozuk işaretlemeyi önlemek için etiketlerin dışındaki metnin kaçışlanması gerekir.
• Signal stil aralıkları kod noktası ofsetlerini değil, UTF-16 ofsetlerini kullanır.
• Kapanış işaretinin kendi satırına yerleşmesi için çitli kod bloklarının sonundaki yeni satırları koruyun.

​

İlgili