{"id":10281,"library":"telegramify-markdown","title":"Telegramify Markdown","description":"telegramify-markdown is a Python library designed to convert standard Markdown text into a format compatible with Telegram's MessageEntity system. It processes Markdown syntax and outputs a plain text string along with a list of `MessageEntity` objects, suitable for sending via the Telegram Bot API. The current version is 1.1.2, and it maintains a moderate release cadence based on feature additions and bug fixes.","status":"active","version":"1.1.2","language":"python","source_language":"en","source_url":"https://github.com/vlad-lazar/telegramify-markdown","tags":["markdown","telegram","converter","bot-api","text-processing"],"install":[{"cmd":"pip install telegramify-markdown","lang":"bash","label":"Install stable version"}],"dependencies":[{"reason":"Core dependency for Markdown parsing.","package":"markdown-it-py","optional":false}],"imports":[{"wrong":"from telegramify_markdown import telegramify_markdown","symbol":"markdownify","correct":"from telegramify_markdown import markdownify"},{"wrong":"from telegramify_markdown import telegramify_markdown","symbol":"convert","correct":"from telegramify_markdown import convert"},{"wrong":"from telegramify_markdown import telegramify_markdown","symbol":"mdv2","correct":"from telegramify_markdown import mdv2"}],"quickstart":{"code":"from telegramify_markdown import telegramify_markdown\n\nmarkdown_text = \"Hello, *world*! This is some _italic_ text and `inline code`.\"\nplain_text, entities = telegramify_markdown(markdown_text)\n\nprint(\"Plain Text:\", plain_text)\nprint(\"Entities:\", entities)\n\n# Example of how you might use it with a Telegram bot library (concept)\n# bot.send_message(chat_id=12345, text=plain_text, entities=entities)","lang":"python","description":"Converts a Markdown string into a tuple containing the plain text and a list of Telegram `MessageEntity` objects. These entities describe the formatting (bold, italic, code, etc.) and their positions in the plain text."},"warnings":[{"fix":"Always destructure the result: `text, entities = telegramify_markdown(...)`. Ensure your Telegram API call uses both `text` and `entities` parameters correctly.","message":"The `telegramify_markdown` function returns a tuple: `(plain_text_string, list_of_message_entities)`. Many users mistakenly expect only a string.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Refer to Telegram's official MarkdownV2 documentation for exact syntax. Test complex Markdown inputs to ensure desired output. For problematic characters, consider escaping them in your input if they are not meant for formatting.","message":"This library aims for compatibility with Telegram's MarkdownV2, which is not identical to CommonMark or GitHub Flavored Markdown. Certain constructs (e.g., `_` for italic within words, complex nested formatting) may not render as expected or may require careful input escaping.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Ensure your environment is running Python 3.10 or a more recent version. You can check your Python version with `python --version`.","message":"The library explicitly requires Python 3.10 or newer. Installing or running on older Python versions will lead to `SyntaxError` or `ModuleNotFoundError` due to modern language features used.","severity":"breaking","affected_versions":"< 1.0.0 (and all subsequent versions)"}],"env_vars":null,"search_vec":"'1.1.2':54 'addit':65 'along':35 'api':49,74 'base':62 'bot':48,73 'bot-api':72 'bug':67 'cadenc':61 'compat':19 'convert':12,71 'current':51 'design':10 'featur':64 'fix':68 'format':18 'librari':9 'list':38 'maintain':57 'markdown':2,5,14,27,69 'messageent':23,40 'moder':59 'object':41 'output':30 'plain':32 'process':26,77 'python':8 'releas':60 'send':44 'standard':13 'string':34 'suitabl':42 'syntax':28 'system':24 'telegram':21,47,70 'telegramifi':1,4 'telegramify-markdown':3 'text':15,33,76 'text-process':75 'version':52 'via':45","created_at":"2026-04-17T01:23:19.549573+00:00","updated_at":"2026-04-17T01:23:19.549573+00:00","problems":null,"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"1.2.0","cli_name":"","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/sudoskys/telegramify-markdown","docs":null,"changelog":null,"pypi":"https://pypi.org/project/telegramify-markdown/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["communication"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-30","last_verified":"2026-06-30","next_check":"2026-07-30","install_tag":null}}