# בריחה ב-MarkdownV2 של Telegram | להיפרד מ-can't parse entities

> בצע בריחה אונליין ובחינם ל-18 התווים השמורים של MarkdownV2 עבור ה-Bot API של Telegram. שני מצבים, קישורים וקוד מוגנים, אזהרה על ישויות שלא נסגרו וקוד מוכן ל-cURL, ל-aiogram או ל-grammY.

- **מקור (source):** https://il.aitoolsforapps.com/telegram-yotsrim-stikrim-vaimog-ym-sh-stickers-mkbl-215/f/escape-markdownv2-telegram-bot-api
- **פלטפורמה (platform):** AiToolsForApps
- **שפה (language):** he

## בקצרה

- בריחה ב-MarkdownV2 ב-Telegram בלי לשבור את ההודעה
- הדבק את הטקסט וקבל את הגרסה אחרי בריחה, מוכנה ל-parse_mode: MarkdownV2, עם 18 התווים השמורים מטופלים והלוכסנים שנוספו מודגשים. חינם, בדפדפן שלך ובלי חשבון.
- כל 18 התווים השמורים, בדיוק כפי שהמפרט קובע
- שני מצבים אמיתיים, לא אחד
- בריחה לפי הקשר, לא בכוח גס

## בריחה ב-MarkdownV2 ב-Telegram בלי לשבור את ההודעה

מנגנון הבריחה ל-MarkdownV2 של Telegram לוקח את הטקסט שאתה עומד לשלוח דרך ה-Bot API ומחזיר לך את אותו טקסט מוכן ל-`parse_mode: "MarkdownV2"`. הוא מבצע בריחה לשמונה עשר התווים ש-Telegram מכריז עליהם כשמורים (_ * [ ] ( ) ~ ` > # + - = | { } . !) ומציג לך את התוצאה עם כל לוכסן הפוך שהוסיף בצבע אחר, כדי שתראה בדיוק מה נגע ולמה.

יש לו שני מצבים, כי בריחה לא תמיד פירושה אותו דבר. במצב מילולי כל הטקסט שלך הוא טקסט: אף כוכבית או קו תחתון לא מפורשים כעיצוב, ולכן מה שאתה כותב הוא מה שנקרא. במצב עם עיצוב נשמרים הסימנים ששמת בכוונה (הדגשה, נטייה, קו תחתון, קו חוצה, ספוילר וציטוטים בתחילת שורה) ושאר הטקסט עובר בריחה. סימן שפתחת ולא סגרת לא עובר בשקט: הוא הופך לתו מילולי ומתריע לך.

מה שמבדיל את מנגנון הבריחה הזה מ-replace עם ביטוי רגולרי הוא שהוא מבין הקשר. בתוך `קוד בתוך השורה` ובלוקים של ``` עוברים בריחה רק הגרש ההפוך והלוכסן ההפוך, כפי שהמפרט דורש. בקישור `[טקסט](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, הוא יפסיק לעבוד. האפליקציה מפעילה כל אחד משלושת הכללים האלה בקטע המתאים לו.

### האם אפשר לבצע בריחה לטקסט בלי לאבד את ההדגשה והנטייה ששמתי בכוונה?

כן, בשביל זה יש את מצב עם עיצוב. במצב הזה מנגנון הבריחה מבחין בין הסימנים ששמת בכוונה (*הדגשה*, _נטייה_, __קו תחתון__, ~קו חוצה~, ||ספוילר|| והציטוט > בתחילת שורה) לבין שאר הטקסט, שעובר בריחה. סימן פתיחה שאין לו סגירה בהמשך לא נשאר תלוי באוויר: הוא הופך לתו מילולי ואתה מקבל אזהרה עם שם הישות המושפעת וכפתור לסגירתה. אם אתה רוצה את ההפך, שבאמת שום דבר לא יפורש כעיצוב, השתמש במצב מילולי: שם כל 18 התווים השמורים עוברים בריחה ומה שאתה כותב הוא בדיוק מה שנקרא.

### האם צריך להירשם או למסור את הטוקן של הבוט שלי כדי להשתמש במנגנון הבריחה?

לא לאחד ולא לשני. הבריחה, זיהוי ישויות שלא נסגרו, התצוגה המקדימה וקטע הקוד מחושבים כולם בדפדפן שלך: אפשר להשתמש בו בלי ליצור חשבון, בלי הגבלה על מספר הפעמים ובלי עלות. והאפליקציה אף פעם לא מבקשת את הטוקן של הבוט שלך ולא שולחת שום דבר ל-Bot API בשמך: קטעי הקוד שאתה מעתיק כוללים סימני מיקום כמו <TU_TOKEN> ו-<CHAT_ID> שאתה ממלא בעצמך בסביבה שלך. הדבר היחיד שדורש חשבון חינמי הוא שמירת הודעה עם הטקסט והכפתורים שלה לשימוש חוזר ביום אחר.

### האם מנגנון הבריחה שובר לי את הקישורים או את הקוד שבהודעה?

לא, כי זו לא החלפת תווים עיוורת: הוא מפרק את הטקסט להקשרים לפני הבריחה. הוא מזהה קישורים [טקסט](https://…), קוד בתוך השורה בין גרשיים הפוכים, בלוקים של ``` עם תווית השפה שלהם ואימוג'ים מותאמים אישית ![x](tg://emoji?id=…), ומפעיל על כל קטע את הכלל המתאים לו. בפועל זה אומר שה-URL שלך מגיע שלם, קטע הקוד שלך לא מתמלא בלוכסנים הפוכים ותווית השפה של הבלוק נשמרת. בנוסף, אם קישור לא מתחיל ב-https:// או ב-tg://, או אם ביעד יש תווים שאינם ASCII שכדאי לקודד, הוא אומר לך את זה במקום להשאיר אותך לגלות זאת בייצור.

- [Telegram — סטיקרים, אימוג'ים ומיתוג לערוצי Telegram עם בינה מלאכותית](https://il.aitoolsforapps.com/telegram-yotsrim-stikrim-vaimog-ym-sh-stickers-mkbl-215)

## על הפלטפורמה

**Telegram — סטיקרים, אימוג'ים ומיתוג לערוצי Telegram עם בינה מלאכותית** — אפליקציה של AiToolsForApps. זמין ב־: https://il.aitoolsforapps.com/telegram-yotsrim-stikrim-vaimog-ym-sh-stickers-mkbl-215/f/escape-markdownv2-telegram-bot-api

### שפות נוספות

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