telegram-pipe-table-renderinglisted

# Telegram Markdown Pipe Table Rendering & CJK Alignment ## Overview A comprehensive engineering guide and solution for rendering Markdown pipe tables in Telegram bots without broken layouts. It covers **Bot API native rendering, CJK character width compensation, standalone cron delivery bypass, and automatic mobile card degradation**. ## When to Use & When NOT to Use ### When to Use - Formatting LLM tabular output for Telegram bots (Hermes, python-telegram-bot, Aiogram). - Fixing character misalignment caused by mixed Chinese/Japanese/Korean and ASCII characters in Monospace tables. - Preventing wide tables (>5 columns) from turning into mangled text on mobile Telegram clients. ### When NOT to Use - Standard web browsers or HTML-native rendering environments where CSS handles table layouts. - Platforms with native rich table APIs (e.g. Discord embeds or Slack blocks). ## The Telegram Table Truth & Solutions Matrix | Delivery Path | Native Table Support | What Actually Happens | Best Solution | |---|:---:|---|---| | **Bot API `sendRichMessage`** | ✅ Yes | Renders native GFM pipe tables | Pass raw markdown directly to `sendRichMessage` endpoint | | **Standard `sendMessage` (MarkdownV2)** | ❌ No | Telegram has no table syntax in MarkdownV2; `|` is just a char | Pre-format with CJK padding or degrade wide tables to cards | | **Standalone Cron / Webhook** | ⚠️ Partial | Often converted to bullet points by intermediary adapters | Direct Bot API webhook or use `telegram-tabl