Convert Markdown to a format usable by Telegram.
Project description
telegramify-markdown
🪄 Python Telegram markdown Converter | No more worrying about formatting.
Raw Markdown -> Telegram MarkdownV2 Style
Before this repo came along, when you wanted to send and render unknown Markdown content (like GitHub's Readme), you had to use complex parsing and reconstruction methods. Today, you can make it easier and customize it to achieve better results!
I used a custom Render to achieve this, using a real environment server to verify the applicability of this tool.
Installation
pip install telegramify-markdown
or if you use pdm
:
pdm add telegramify-markdown
Supported Features
- Headings (1-6)
- Links text
- Images ![alt]
- Lists (Ordered, Unordered)
- Tables |-|-|
- Horizontal Rule ----
- Text Styles
- Underline
- Code Blocks
-
Inline Code
- Block Quotes
-
Strikethrough - Task Lists
-
Strikethrough - ||Spoiler||
- Tg Emoji
- Tg User At
[!NOTE] Since mistletoe doesn't parse TODO and Spoiler, we can't apply it.
Strikethroughis incorrect, even if it comes from official documentation, please useStrikethroughformat.
Use case
import telegramify_markdown
from telegramify_markdown.customize import markdown_symbol
markdown_symbol.head_level_1 = "📌" # If you want, Customizing the head level 1 symbol
markdown_symbol.link = "🔗" # If you want, Customizing the link symbol
md = """
'\_', '\*', '\[', '\]', '\(', '\)', '\~', '\`', '\>', '\#', '\+', '\-', '\=', '\|', '\{', '\}', '\.', '\!'
_ , * , [ , ] , ( , ) , ~ , ` , > , # , + , - , = , | , { , } , . , !
**bold text**
*bold text*
_italic text_
__underline__
~no valid strikethrough~
~~strikethrough~~
||spoiler||
*bold _italic bold ~~italic bold strikethrough ||italic bold strikethrough spoiler||~~ __underline italic bold___ bold*
__underline italic bold__
[link](https://www.google.com)
- [ ] Uncompleted task list item
- [x] Completed task list item
> Quote
```python
print("Hello, World!")
```
This is `inline code`
1. First ordered list item
2. Another item
- Unordered sub-list.
1. Actual numbers don't matter, just that it's a number
"""
converted = telegramify_markdown.convert(md)
print(converted)
output as follows:
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for telegramify_markdown-0.1.3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | f2d90cba23622b871fb2cf1b775c6f585660526a255550fc82f467491c852e60 |
|
MD5 | 747d5be6bbb6f0eb004c0fbc5bbbcedc |
|
BLAKE2b-256 | d520d13f2fe4509e1edb1f9f9c70524ec7cad908206188edc69379684e83bc7b |
Hashes for telegramify_markdown-0.1.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 71c4f865bced161bec70dc59c65b89273684d6266863be73115366361211ae97 |
|
MD5 | 183caa97ec02661031145ba1e2175968 |
|
BLAKE2b-256 | 0503577f58a01c513762bab1f79bf96e73af5ea20c472cb8f6e8f55cfbb60c55 |