# Telegram MarkdownV2 escape | Hyvästi can't parse entities

> Escapeta verkossa ja ilmaiseksi MarkdownV2:n 18 varattua merkkiä Telegramin Bot API:a varten. Kaksi tilaa, suojatut linkit ja koodi, varoitus sulkemattomista entiteeteistä ja valmis koodi cURL:lle, aiogramille tai grammY:lle.

- **Lähde (source):** https://fi.aitoolsforapps.com/telegram-tee-telegram-tarroja-ja-emojeja-jotka-stickers-hyvaksyy-215/f/escapeta-markdownv2-telegram-bot-api
- **Alusta (platform):** AiToolsForApps
- **Kieli (language):** fi

## Lyhyesti

- Escapeta MarkdownV2 Telegramissa rikkomatta viestiä
- Liitä tekstisi ja saat escapetetun version valmiina parse_mode: MarkdownV2:lle, 18 varattua merkkiä ratkaistuna ja lisätyt kenoviivat korostettuina. Ilmainen, selaimessasi ja ilman tiliä.
- Kaikki 18 varattua merkkiä, täsmälleen kuten määrittely sanoo
- Kaksi todellista tilaa, ei yksi
- Escapetus kontekstin mukaan, ei raakaa voimaa

## Escapeta MarkdownV2 Telegramissa rikkomatta viestiä

Telegramin MarkdownV2-escape-työkalu ottaa Bot API:lla lähettämäsi tekstin ja palauttaa saman tekstin valmiina `parse_mode: "MarkdownV2"` -asetukselle. Se escapetoi kahdeksantoista merkkiä, jotka Telegram ilmoittaa varatuiksi – _ * [ ] ( ) ~ ` > # + - = | { } . ! – ja näyttää tuloksen niin, että jokainen lisäämänsä kenoviiva on toisella värillä, jotta näet täsmälleen, mihin se on koskenut ja miksi.

Siinä on kaksi tilaa, koska escapetus ei aina tarkoita samaa. Kirjaimellinen-tilassa koko tekstisi on tekstiä: mitään tähteä tai alaviivaa ei tulkita muotoiluksi, joten se, mitä kirjoitat, on se, mitä luetaan. Muotoiltu-tilassa tarkoituksella laittamasi merkit – lihavointi, kursiivi, alleviivaus, yliviivaus, spoileri ja rivin alun lainaukset – säilytetään ja kaikki muu escapetoidaan. Merkki, jonka avaat ja jota et sulje, ei livahda läpi: se muutetaan kirjaimelliseksi merkiksi ja saat varoituksen.

Se, mikä erottaa tämän escape-työkalun säännöllisen lausekkeen replacesta, on kontekstin ymmärtäminen. `Rivinsisäisen koodin` ja ``` -lohkojen sisällä escapetetaan vain gravis ja kenoviiva, kuten määrittely vaatii. Linkissä `[teksti](url)` näkyvä teksti escapetetaan mutta kohde ei, paitsi sulkeva sulku ja kenoviiva: näin URL:si saapuvat ehjinä sen sijaan että täyttyisivät kenoviivoista ja lakkaisivat toimimasta. Se tunnistaa myös mukautetut emojit `![x](tg://emoji?id=…)` ja päästää ne läpi kokonaisina.

Ja ennen kuin viesti lähtee, se tarkistaa. Se havaitsee avoimet ja sulkemattomat entiteetit ja kertoo, mikä se on – lihavointi, kursiivi, koodi, lohko, hakasulje – painikkeella, jolla sen voi sulkea tai escapetoida yhdellä napsautuksella. Se varoittaa, jos linkki ei ala https:// tai tg://, jos kohteessa on ei-ASCII-merkkejä, jotka sinun pitäisi koodata, jos teksti oli jo tullut kenoviivoineen ja olit escapetoimassa sen kahdesti, ja jos ylität 4096 merkkiä, joihin Telegram katkaisee. Alla on esikatselu oikeassa Telegram-kuplassa, rakennettuna escapetettua tekstiä lukemalla, ja valmiiksi koottu koodipätkä cURL:lle, raa'alle Bot API:lle, python-telegram-botille, aiogramille, telegrafille tai grammY:lle.

## Mitä se sisältää

- **Kaikki 18 varattua merkkiä, täsmälleen kuten määrittely sanoo** — _ * [ ] ( ) ~ ` > # + - = | { } . ! – piste ja huutomerkki mukaan lukien, sillä ne rikkovat eniten viestejä.
- **Kaksi todellista tilaa, ei yksi** — Kirjaimellinen, jotta tekstisi pysyy tekstinä, ja Muotoiltu, jotta säilytät lihavoinnin, kursiivin, alleviivauksen, yliviivauksen, spoilerin ja lainauksen ja escapetat kaiken muun.
- **Escapetus kontekstin mukaan, ei raakaa voimaa** — rivinsisäinen koodi ja ``` -lohkot saavat vain sen escapen, jota määrittely vaatii, ja linkeissä näkyvä teksti escapetetaan mutta URL ei, joten linkkisi toimivat edelleen.
- **Näet, mikä on muuttunut** — jokainen lisätty kenoviiva korostetaan alkuperäisen tekstin päällä, ja linkkinä tai koodina käsitellyt jaksot merkitään erikseen. Ei sokeaa luottamusta mustaan laatikkoon.
- **Varoittaa ennen kuin Bot API palauttaa 400-virheen** — sulkemattomat entiteetit nimineen, orvot hakasulkeet, irralliset gravismerkit, linkit ilman https://, URL:t ei-ASCII-merkeillä, jo escapetettu teksti ja yli 4096 merkin viestit.
- **Korjaukset yhdellä napsautuksella** — jokaisella varoituksella on oma painikkeensa – sulje entiteetti, escapeta merkki tai poista tekstissä jo olleet kenoviivat – ja escapetus lasketaan heti uudelleen tulokselle.
- **Esikatselu oikeassa Telegram-kuplassa** — escapetettu teksti tulkitaan uudelleen ja piirretään sellaisena kuin käyttäjäsi sen näkee, vaaleassa ja tummassa teemassa, ennen kuin mitään lähetetään.
- **Ja koodi valmiiksi koottuna** — kopioi valmis pätkä cURL:lle, raa'alle Bot API:lle, python-telegram-botille, aiogramille, telegrafille tai grammY:lle, tokenpaikkamerkeillä oikeiden tunnistetietojen sijaan. Emme koskaan pyydä bottisi tokenia.

## Usein kysytyt kysymykset

### Miksi saan virheen can't parse entities lähettäessäni viestin MarkdownV2:lla?

Koska tekstissä on jokin niistä 18 merkistä, joita MarkdownV2 pitää varattuina ilman edessä olevaa kenoviivaa: _ * [ ] ( ) ~ ` > # + - = | { } . ! Telegram yrittää tulkita ne muotoilumerkeiksi, ei löydä odottamaansa sulkevaa merkkiä ja hylkää viestin virheellä 400 "can't parse entities". Yleisimmät syylliset ovat lauseen loppupiste, luettelon yhdysmerkki ja sulkeet, juuri koska kukaan ei yhdistä niitä muotoiluun. MarkdownV2-escape-työkalu käy tekstisi läpi ja lisää kenoviivan sinne, missä tarvitaan, korostaen jokaisen, jotta näet, mihin se on koskenut, ja varoittaa lisäksi, jos viestin rikkoo avoin ja sulkematon entiteetti irrallisen merkin sijaan.

### Mitkä merkit pitää escapetoida Telegramin MarkdownV2:ssa?

Niitä on kahdeksantoista: alaviiva (_), tähti (*), hakasulkeet ([ ja ]), sulkeet (( ja )), tilde (~), gravis (`), suurempi kuin -merkki (>), risuaita (#), plusmerkki (+), yhdysmerkki (-), yhtäsuuruusmerkki (=), pystyviiva (|), aaltosulkeet ({ ja }), piste (.) ja huutomerkki (!). Koodilohkon tai rivinsisäisen koodijakson sisällä sääntö muuttuu: siellä escapetetaan vain gravis ja kenoviiva. Ja linkissä [teksti](url) näkyvä teksti on escapetettava, mutta kohteessa vain sulkeva sulku ja kenoviiva: jos escapetat koko URL:n, se lakkaa toimimasta. Sovellus soveltaa kutakin näistä kolmesta säännöstä omaan jaksoonsa.

### Voinko escapetoida tekstin menettämättä tarkoituksella laittamaani lihavointia ja kursiivia?

Kyllä, sitä varten on Muotoiltu-tila. Siinä tilassa escape-työkalu erottaa merkit, jotka olet pannut tarkoituksella – *lihavointi*, _kursiivi_, __alleviivaus__, ~yliviivaus~, ||spoiler|| ja rivin alussa oleva lainaus > – muusta tekstistä, jonka se escapetoi. Avaava merkki, jolla ei ole sulkevaa merkkiä myöhemmin, ei jää puolitiehen: se muutetaan kirjaimelliseksi merkiksi ja saat varoituksen, jossa on asianomaisen entiteetin nimi ja painike sen sulkemiseen. Jos haluat päinvastoin, että mitään ei tulkita muotoiluksi, käytä Kirjaimellinen-tilaa: siinä kaikki 18 varattua escapetoidaan ja se, mitä kirjoitat, on täsmälleen se, mitä luetaan.

### Pitääkö minun rekisteröityä tai antaa bottini token escape-työkalun käyttöön?

Et kumpaakaan. Escapetus, sulkemattomien entiteettien tunnistus, esikatselu ja koodipätkä lasketaan kokonaan selaimessasi: voit käyttää sitä ilman tiliä, rajattomasti ja ilman kustannuksia. Ja sovellus ei koskaan pyydä bottisi tokenia eikä lähetä mitään Bot API:lle puolestasi: kopioimissasi koodipätkissä on paikkamerkit <TU_TOKEN> ja <CHAT_ID>, jotka täytät itse omassa ympäristössäsi. Ainoa asia, joka vaatii ilmaisen tilin, on viestin tallentaminen teksteineen ja painikkeineen uudelleenkäyttöä varten toisena päivänä.

### Rikkooko escape-työkalu viestini linkit tai koodin?

Ei, koska se ei ole sokea merkkien korvaus: se tokenisoi tekstin konteksteittain ennen escapetusta. Se tunnistaa linkit [teksti](https://…), rivinsisäisen koodin gravismerkkien välissä, ``` -lohkot kielitunnisteineen ja mukautetut emojit ![x](tg://emoji?id=…), ja soveltaa kuhunkin jaksoon sille kuuluvaa sääntöä. Käytännössä se tarkoittaa, että URL:si saapuu kokonaisena, koodipätkäsi ei täyty kenoviivoista ja lohkon kielitunniste säilyy. Lisäksi jos linkki ei ala https:// tai tg://, tai jos kohde sisältää ei-ASCII-merkkejä, jotka kannattaisi koodata, se kertoo siitä sen sijaan että antaisi sinun huomata sen tuotannossa.

- [Telegram — Tarrat, emojit ja brändäys Telegram-kanaville tekoälyllä](https://fi.aitoolsforapps.com/telegram-tee-telegram-tarroja-ja-emojeja-jotka-stickers-hyvaksyy-215)

## Tietoa alustasta

**Telegram — Tarrat, emojit ja brändäys Telegram-kanaville tekoälyllä** — sovellus: AiToolsForApps. Saatavilla kielillä: https://fi.aitoolsforapps.com/telegram-tee-telegram-tarroja-ja-emojeja-jotka-stickers-hyvaksyy-215/f/escapeta-markdownv2-telegram-bot-api

### Muut kielet

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