منسّق نصوص Telegram: غامق ومائل وسبويلر وMarkdownV2

التنسيق في Telegram ليس طباعةً بل بيانات. الكلمة الغامقة كيان: نوع وإزاحة وطول ملحقة بنص عادي. التطبيقات ترسمه، والبوتات ترسله، وكل ما يسوء في رسالة منسّقة يسوء عند النقطة التي يتحول فيها النص إلى كيانات.

عشرة أنماط وترميز واحد

يقبل الحقل أعلاه ترميزًا صغيرًا ويحوّله إلى كيانات وأنت تكتب: **غامق**، __مائل__، ++مسطّر++، ~~مشطوب~~، ||سبويلر||، زوج من علامات التنصيص المائلة للكود داخل السطر، سياج ``` في سطر مستقل لكتلة كود (تُكتب اللغة بعد سياج الفتح)، [نص](url) للرابط، وسطر يبدأ بـ > للاقتباس أو بـ >> للاقتباس القابل للتوسيع. الشرطة المائلة العكسية قبل أي من هذه الرموز تُبقيه نصًا. الأنماط تتداخل، فيجوز أن يقع رابط داخل غامق وغامق داخل اقتباس؛ الكود لا يحوي شيئًا، والاقتباس لا يحوي اقتباسًا آخر ولا كتلة كود. تلك هي قواعد التداخل التي يطبّقها Telegram نفسه لا قيد من هذه الصفحة.

تُظهر المعاينة ما تعنيه الكيانات لا كيف يرسمها تطبيق بعينه بكسلًا بكسل. تبقى السبويلرات مخفية حتى تنقر عليها. ويقيس العدّاد أسفل الحقل النص بلا ترميز، لأنه النص الذي يقيسه Telegram.

MarkdownV2: التهريب الذي يعطّل البوتات

parse_mode=MarkdownV2 هو الصيغة التي تعرضها معظم الشروحات، وهو ما يقف وراء معظم أخطاء «can’t parse entities». القاعدة قصيرة وقاسية: خارج الكود، يجب أن تسبق شرطة مائلة عكسية كلًا من الأحرف _ * [ ] ( ) ~ ` > # + - = | { } . !، والشرطة المائلة العكسية نفسها كذلك. نقطة واحدة غير مهرَّبة في آخر الجملة تكفي ليرفض الـAPI الرسالة كلها. داخل code وpre لا يُهرَّب إلا علامة التنصيص المائلة والشرطة العكسية؛ وداخل جزء العنوان من الرابط لا يُهرَّب إلا قوس الإغلاق والشرطة العكسية.

وثمة فخ آخر. الشرطتان السفليتان تُقرآن دائمًا تسطيرًا، بنهم، من اليسار إلى اليمين، ولذلك لا يمكن كتابة مائلٍ ينتهي حيث ينتهي التسطير تمامًا كتابةً ساذجة. الحل الموثّق: أغلق المائل، وأدخل كيان غامق فارغًا ** فاصلًا، ثم أغلق التسطير. مخرج MarkdownV2 أعلاه يفعل ذلك كله بما فيه الفاصل، ولهذا يستحق النسخ لا إعادة الكتابة.

HTML: ثلاثة أحرف للتهريب

parse_mode=HTML هو الخيار الأهدأ. يدعم Telegram قائمة ثابتة من الوسوم: b وi وu وs وtg-spoiler وa وcode وpre (مع code class="language-…" متداخل لتسمية اللغة) وblockquote عاديًا أو expandable. ثلاثة أحرف فقط في نصك تحتاج إلى انتباه: < و> و&، وتُستبدل بـ< و> و&. كل ما عداها، بما فيه النقاط والشرطات التي تجعل MarkdownV2 هشًا، يُرسل كما هو. إنها الصيغة التي يستخدمها AdminHub نفسه حين ينشر المنشورات، والصيغة التي يُستحسن اختيارها لأي بوت يُكتب من الصفر.

Entities، إن كنت تفضّل ألا تهرّب شيئًا

المخرج الثالث هو مصفوفة entities. أرسِلها مع النص العادي وبلا parse_mode، فلن يبقى ما يُهرَّب لأن شيئًا لا يُحلَّل. الشيء الوحيد الذي يلزم معرفته هو الوحدة: تُحسب الإزاحات والأطوال بوحدات UTF-16، فيُحسب الإيموجي أو أي حرف خارج المستوى الأساسي متعدد اللغات وحدتين. ولهذا السبب بالضبط يعرض العدّاد هذا الرقم على حدة.

ما أقصى طول للرسالة

تتّسع الرسالة لـ4,096 حرفًا وتعليق الوسائط لـ1,024، وكلاهما «بعد تحليل الكيانات»: الترميز والوسوم وشرطات التهريب لا تُحسب، بل النص الذي يراه القارئ فقط. الحدود معلنة بالأحرف، وإعدادات عميل Telegram تعدّها نقاط ترميز، فالإيموجي الغامق حرف واحد أمام الحد وإن كان كيانه بطول وحدتين. يتبع العدّاد أعلاه هذه القاعدة ويبدّل بين الحدين؛ ويشرح مولّد الخطوط الفرق نفسه للحروف اليونيكودية المزخرفة.

ما لا تفعله هذه الأداة

الإيموجي المخصص وكيانات التاريخ tg-time تحتاج إلى بوت بصلاحيات معيّنة، ولذلك استُبعدت. الوضع القديم Markdown مستبعد عمدًا: فهو لا يتداخل، ولا يعبّر عن التسطير أو الشطب أو السبويلر أو الاقتباس، وتوثيق Telegram نفسه يحيل إلى MarkdownV2. كما أن العناوين والجداول والقوائم ليست من تنسيق الرسائل العادي: قدّمها Telegram في يوليو 2026 كمحرّر نص غني منفصل لمستخدمي Premium، وبالنسبة إلى البوتات فهي رسائل Bot API 10.1 الغنية، وهي ما ينتجه محرّر منشورات AdminHub. أما أنماط هذه الصفحة فيعرضها كل عميل Telegram بالطريقة نفسها.

المصادر، روجعت في سبتمبر 2026: Bot API, Formatting options لقواعد تهريب MarkdownV2 وقائمة وسوم HTML وقواعد التداخل وحدود «بعد تحليل الكيانات»؛ Bot API, MessageEntity للإزاحات والأطوال بوحدات UTF-16؛ Styled text with message entities عن طريقة عدّ العملاء لأطوال الكيانات؛ مدونة Telegram، 14 يوليو 2026 عن محرّر النص الغني وإتاحته لمشتركي Premium فقط.