# تهريب MarkdownV2 في Telegram | وداعًا can't parse entities

> هرّب أونلاين ومجانًا الأحرف الـ18 المحجوزة في MarkdownV2 لواجهة Telegram Bot API. وضعان، وروابط وكود محميان، وتنبيه بالكيانات غير المغلقة، وكود جاهز لـ cURL أو aiogram أو grammY.

- **المصدر (source):** https://qa.aitoolsforapps.com/telegram-anshi-mlsqat-wiimuji-telegram-yqblha-stickers-215/f/escape-markdownv2-telegram-bot-api
- **المنصة (platform):** AiToolsForApps
- **اللغة (language):** ar

## باختصار

- تهريب MarkdownV2 في Telegram دون كسر الرسالة
- الصق نصك واحصل على النسخة المُهرَّبة الجاهزة لـ parse_mode: MarkdownV2، مع حل الأحرف الـ18 المحجوزة وتظليل الشرطات المضافة. مجانًا وفي متصفحك وبلا حساب.
- الأحرف الـ18 المحجوزة كما تنص المواصفات تمامًا
- وضعان حقيقيان لا وضع واحد
- تهريب بحسب السياق لا بالقوة العمياء

## تهريب MarkdownV2 في Telegram دون كسر الرسالة

يأخذ مهرِّب MarkdownV2 الخاص بـ Telegram النص الذي ستُرسله عبر Bot API ويعيده إليك مهيّأً لـ `parse_mode: "MarkdownV2"`. فيهرّب الأحرف الثمانية عشر التي يعلنها Telegram محجوزة، وهي _ * [ ] ( ) ~ ` > # + - = | { } . !، ويعرض لك النتيجة مع كل شرطة مائلة عكسية أضافها بلون آخر، لترى بالضبط ما الذي مسّه ولماذا.

له وضعان، لأن التهريب لا يعني الشيء نفسه دائمًا. ففي الوضع «حرفي» يكون نصك كله نصًا: فلا تُفسَّر أي نجمة أو شرطة سفلية على أنها تنسيق، فما تكتبه هو ما يُقرأ. وفي الوضع «مع التنسيق» تُحترم العلامات التي وضعتها عمدًا، من خط عريض ومائل وتسطير وشطب وسبويلر واقتباسات في بداية السطر، ويُهرَّب كل ما عداها. والعلامة التي تفتحها ولا تغلقها لا تمرّ: بل تتحول إلى حرف حرفي وتصلك رسالة تنبيه.

ما يميز هذا المهرِّب عن استبدال بتعبير نمطي هو أنه يفهم السياق. فداخل `الكود المضمَّن` وكتل ``` لا يُهرَّب إلا علامة الاقتباس العكسي والشرطة المائلة العكسية، كما تطلب المواصفات. وفي الرابط `[نص](url)` يُهرَّب النص الظاهر ولا تُهرَّب الوجهة، باستثناء القوس الختامي والشرطة: فتصل عناوين URL سليمة بدل أن تمتلئ بالشرطات وتتوقف عن العمل. كما يتعرف على الإيموجي المخصصة `![x](tg://emoji?id=…)` ويتركها تمرّ كاملة.

وقبل أن تخرج الرسالة يراجعها. فيكشف الكيانات المفتوحة غير المغلقة ويخبرك أيّها هي، وهي عريض أو مائل أو كود أو كتلة أو قوس مربع، مع زر لإغلاقها أو تهريبها بنقرة. وينبّهك إذا كان الرابط لا يبدأ بـ https:// أو tg://، أو كانت الوجهة تحمل أحرفًا غير ASCII ينبغي ترميزها، أو كان النص يحمل أصلًا شرطات مائلة عكسية وكنت ستهرّبه مرتين، أو إذا تجاوزت 4096 حرفًا التي يقطع Telegram عندها الرسالة. وتحت ذلك المعاينة في فقاعة Telegram حقيقية، مبنية بقراءة النص المُهرَّب، ومقطع الكود الجاهز لـ cURL وBot API الخام وpython-telegram-bot وaiogram وtelegraf وgrammY.

## ما الذي يتضمنه

- **الأحرف الـ18 المحجوزة كما تنص المواصفات تمامًا** — _ * [ ] ( ) ~ ` > # + - = | { } . ! — دون إغفال النقطة وعلامة التعجب، وهما الأكثر تسببًا في كسر الرسائل.
- **وضعان حقيقيان لا وضع واحد** — «حرفي» ليبقى نصك نصًا، و«مع التنسيق» للاحتفاظ بالخط العريض والمائل والتسطير والشطب والسبويلر والاقتباس، مع تهريب كل ما عداها.
- **تهريب بحسب السياق لا بالقوة العمياء** — فالكود المضمَّن وكتل ``` تتلقى فقط التهريب الذي تطلبه المواصفات، وفي الروابط يُهرَّب النص الظاهر لا عنوان URL، فتبقى روابطك تعمل.
- **ترى ما تغيّر** — كل شرطة مائلة عكسية مضافة تظهر مظلَّلة فوق النص الأصلي، وتُميَّز على حدة المقاطع المعاملة كرابط أو ككود. فلا حاجة إلى الثقة العمياء في صندوق أسود.
- **ينبّهك قبل أن تعيد إليك Bot API الخطأ 400** — كيانات غير مغلقة مع اسمها، وأقواس يتيمة، وعلامات الاقتباس العكسية المنفردة، وروابط بلا https://، وعناوين URL بأحرف غير ASCII، ونصًا مُهرَّبًا مسبقًا، ورسائل تتجاوز 4096 حرفًا.
- **إصلاحات بنقرة واحدة** — لكل تنبيه زره، وهو إغلاق الكيان أو تهريب الحرف أو إزالة الشرطات التي كان النص يحملها أصلًا، ويُعاد حساب التهريب فورًا على النتيجة.
- **معاينة في فقاعة Telegram حقيقية** — يُعاد تفسير النص المُهرَّب ويُعرض كما سيراه مستخدمك، بالوضعين الفاتح والداكن، قبل إرسال أي شيء.
- **والكود جاهز** — انسخ المقطع الجاهز لـ cURL أو Bot API الخام أو python-telegram-bot أو aiogram أو telegraf أو grammY، مع علامات للتوكن بدل بيانات الاعتماد الحقيقية. ولا نطلب منك أبدًا توكن البوت.

## الأسئلة الشائعة

### لماذا يظهر لي الخطأ can't parse entities عند إرسال رسالة بـ MarkdownV2؟

لأن النص يحتوي على أحد الأحرف الـ18 التي يعدّها MarkdownV2 محجوزة دون شرطة مائلة عكسية قبلها: _ * [ ] ( ) ~ ` > # + - = | { } . ! يحاول Telegram تفسيرها علامات تنسيق، فلا يجد الإغلاق الذي ينتظره، فيرفض الرسالة بالخطأ 400 "can't parse entities". والمتسببون الأكثر شيوعًا هم النقطة في نهاية الجملة وواصلة القائمة والأقواس، وذلك تحديدًا لأن أحدًا لا يربطها بالتنسيق. ويمرّ مهرِّب MarkdownV2 الخاص بـ Telegram على نصك ويضيف الشرطة المائلة العكسية حيث يلزم، ويظلل كل واحدة لترى ما الذي مسّه، كما ينبّهك إن كان ما يكسر الرسالة كيانًا مفتوحًا غير مغلق لا حرفًا منفردًا.

### ما الأحرف التي يجب تهريبها في MarkdownV2 الخاص بـ Telegram؟

هي ثمانية عشر حرفًا: الشرطة السفلية (_) والنجمة (*) والقوسان المربعان ([ و]) والقوسان العاديان (( و)) والتلدة (~) وعلامة الاقتباس العكسي (`) وعلامة أكبر من (>) وعلامة الشباك (#) وعلامة الزائد (+) والواصلة (-) وعلامة المساواة (=) والشريط العمودي (|) والقوسان المعقوفان ({ و}) والنقطة (.) وعلامة التعجب (!). وداخل كتلة كود أو مقطع كود مضمَّن تتغير القاعدة: فهناك يُهرَّب فقط علامة الاقتباس العكسي والشرطة المائلة العكسية. وفي الرابط [نص](url) يجب تهريب النص الظاهر، أما في الوجهة فيُهرَّب فقط القوس الختامي والشرطة المائلة العكسية: وإذا هرّبت عنوان URL كاملًا يتوقف عن العمل. ويطبّق Telegram كلًا من هذه القواعد الثلاث على المقطع الخاص بها.

### هل يمكنني تهريب النص دون أن أفقد الخط العريض والمائل اللذين وضعتهما عمدًا؟

نعم، وهذا هو سبب وجود وضع «مع التنسيق». ففي هذا الوضع يميّز المهرِّب بين العلامات التي وضعتها عن قصد، وهي *عريض* و_مائل_ و__تسطير__ و~شطب~ و||سبويلر|| والاقتباس > في بداية السطر، وبين بقية النص الذي يهرّبه. وعلامة الفتح التي لا يوجد لها إغلاق لاحقًا لا تُترك ناقصة: بل تتحول إلى حرف حرفي وتتلقى تنبيهًا باسم الكيان المعني وزرًّا لإغلاقها. وإذا كنت تريد العكس، أي ألا يُفسَّر شيء إطلاقًا على أنه تنسيق، فاستخدم الوضع «حرفي»: فهناك تُهرَّب الأحرف الـ18 المحجوزة كلها، وما تكتبه هو بالضبط ما يُقرأ.

### هل يلزم التسجيل أو إعطاء توكن بوتي لاستخدام المهرِّب؟

لا في الحالتين. فالتهريب وكشف الكيانات غير المغلقة والمعاينة ومقطع الكود تُحسب كلها داخل متصفحك: يمكنك استخدامه دون إنشاء حساب ودون حد لعدد المرات ودون تكلفة. والتطبيق لا يطلب توكن بوتك أبدًا ولا يرسل شيئًا إلى Bot API نيابةً عنك: فمقاطع الكود التي تنسخها تحمل علامات مثل <TU_TOKEN> و<CHAT_ID> تملؤها أنت في بيئتك الخاصة. والشيء الوحيد الذي يحتاج إلى حساب مجاني هو حفظ رسالة بنصها وأزرارها لإعادة استخدامها في يوم آخر.

### هل يكسر المهرِّب روابط رسالتي أو الكود فيها؟

لا، لأنه ليس استبدالًا أعمى للأحرف: إذ يقسّم النص بحسب السياقات قبل التهريب. فهو يتعرف على الروابط [نص](https://…) والكود المضمَّن بين علامتي الاقتباس العكسي وكتل ``` بوسم اللغة والإيموجي المخصصة ![x](tg://emoji?id=…)، ويطبّق على كل مقطع القاعدة الخاصة به. وعمليًا يعني ذلك أن عنوان URL يصل كاملًا، وأن مقطع الكود لا يمتلئ بالشرطات المائلة العكسية، وأن وسم لغة الكتلة يبقى محفوظًا. وإضافة إلى ذلك، إذا كان الرابط لا يبدأ بـ https:// أو tg://، أو كانت الوجهة تحمل أحرفًا غير ASCII يُستحسن ترميزها، فإنه يخبرك بذلك بدل أن تكتشفه في بيئة الإنتاج.

- [Telegram — ملصقات وإيموجي وهوية قنوات Telegram بالذكاء الاصطناعي](https://qa.aitoolsforapps.com/telegram-anshi-mlsqat-wiimuji-telegram-yqblha-stickers-215)

## عن المنصة

**Telegram — ملصقات وإيموجي وهوية قنوات Telegram بالذكاء الاصطناعي** — تطبيق من AiToolsForApps. متاح في: https://qa.aitoolsforapps.com/telegram-anshi-mlsqat-wiimuji-telegram-yqblha-stickers-215/f/escape-markdownv2-telegram-bot-api

### لغات أخرى

- `es`: https://qa.aitoolsforapps.com/es/aitelegram-stickers-emojis-y-branding-para-telegram-215/f/escapar-markdownv2-telegram-bot-api
- `en`: https://qa.aitoolsforapps.com/en/aitelegram-stickers-emojis-and-branding-for-telegram-215/f/escape-markdownv2-telegram-bot-api
- `fr`: https://qa.aitoolsforapps.com/fr/aitelegram-stickers-emojis-et-branding-pour-telegram-215/f/escape-markdownv2-telegram-bot-api
- `it`: https://qa.aitoolsforapps.com/it/aitelegram-stickers-emojis-e-branding-per-telegram-215/f/escape-markdownv2-telegram-bot-api
- `pt`: https://qa.aitoolsforapps.com/pt/aitelegram-stickers-emojis-e-branding-para-telegram-215/f/escape-markdownv2-telegram-bot-api
- `de`: https://qa.aitoolsforapps.com/de/aitelegram-stickers-emojis-und-branding-fuer-telegram-215/f/escape-markdownv2-telegram-bot-api
- `bg`: https://qa.aitoolsforapps.com/bg/telegram-sazdavayte-stikeri-i-emodzhita-koito-stickers-priema-215/f/ekranirane-na-markdownv2-telegram-bot-api
- `ja`: https://qa.aitoolsforapps.com/ja/telegram-sticker-emoji-sakusei-215/f/telegram-markdownv2-escape-bot-api
- `nl`: https://qa.aitoolsforapps.com/nl/telegram-maak-telegram-stickers-en-emoji-s-die-stickers-accepteert-215/f/markdownv2-escapen-telegram-bot-api
- `ko`: https://qa.aitoolsforapps.com/ko/telegram-sticker-emoji-channel-branding-215/f/telegram-markdownv2-escape-bot-api
- `sv`: https://qa.aitoolsforapps.com/sv/telegram-skapa-telegram-stickers-och-emojis-som-stickers-godkanner-215/f/skydda-markdownv2-telegram-bot-api
- `da`: https://qa.aitoolsforapps.com/da/telegram-lav-telegram-stickers-og-emojis-som-stickers-accepterer-215/f/escape-markdownv2-telegram-bot-api
- `id`: https://qa.aitoolsforapps.com/id/telegram-buat-stiker-dan-emoji-telegram-yang-diterima-stickers-215/f/escape-markdownv2-telegram-bot-api
- `cs`: https://qa.aitoolsforapps.com/cs/telegram-stickery-a-emoji-pro-telegram-ktere-stickers-prijme-215/f/osetreni-markdownv2-telegram-bot-api
- `fi`: https://qa.aitoolsforapps.com/fi/telegram-tee-telegram-tarroja-ja-emojeja-jotka-stickers-hyvaksyy-215/f/escapeta-markdownv2-telegram-bot-api
- `zh`: https://qa.aitoolsforapps.com/zh/telegram-stickers-emojis-branding-215/f/tiaotuo-markdownv2-telegram-bot-api
- `pl`: https://qa.aitoolsforapps.com/pl/telegram-tworz-stickery-i-emoji-ktore-przyjmie-stickers-215/f/escapowanie-markdownv2-telegram-bot-api
- `no`: https://qa.aitoolsforapps.com/no/telegram-lag-telegram-stickers-og-emojier-stickers-godtar-215/f/escape-markdownv2-telegram-bot-api
- `he`: https://qa.aitoolsforapps.com/he/telegram-yotsrim-stikrim-vaimog-ym-sh-stickers-mkbl-215/f/escape-markdownv2-telegram-bot-api
