97 lines
2.5 KiB
ReStructuredText
97 lines
2.5 KiB
ReStructuredText
Text Formatting
|
|
===============
|
|
|
|
Pyrogram, just like the `Telegram Bot API`_, natively supports basic Markdown and HTML formatting styles for text
|
|
messages and media captions.
|
|
|
|
Markdown style uses the same syntax as Telegram Desktop's and is enabled by default.
|
|
|
|
Beside bold, italic, and pre-formatted code, **Pyrogram does also support inline URLs and inline mentions of users**.
|
|
|
|
Markdown Style
|
|
--------------
|
|
|
|
To use this mode, pass :obj:`MARKDOWN <pyrogram.ParseMode.MARKDOWN>` or "markdown" in the *parse_mode* field when using
|
|
:obj:`send_message() <pyrogram.Client.send_message>`. Use the following syntax in your message:
|
|
|
|
.. code-block:: text
|
|
|
|
**bold text**
|
|
|
|
__italic text__
|
|
|
|
[inline URL](https://docs.pyrogram.ml/)
|
|
|
|
[inline mention of a user](tg://user?id=23122162)
|
|
|
|
`inline fixed-width code`
|
|
|
|
```block_language
|
|
pre-formatted fixed-width code block
|
|
```
|
|
|
|
|
|
HTML Style
|
|
----------
|
|
|
|
To use this mode, pass :obj:`HTML <pyrogram.ParseMode.HTML>` or "html" in the *parse_mode* field when using
|
|
:obj:`send_message() <pyrogram.Client.send_message>`. The following tags are currently supported:
|
|
|
|
.. code-block:: text
|
|
|
|
<b>bold</b>, <strong>bold</strong>
|
|
|
|
<i>italic</i>, <em>italic</em>
|
|
|
|
<a href="http://docs.pyrogram.ml/">inline URL</a>
|
|
|
|
<a href="tg://user?id=23122162">inline mention of a user</a>
|
|
|
|
<code>inline fixed-width code</code>
|
|
|
|
<pre>pre-formatted fixed-width code block</pre>
|
|
|
|
.. note:: Mentions are only guaranteed to work if you have already met the user (in groups or private chats).
|
|
|
|
Examples
|
|
--------
|
|
|
|
- Markdown:
|
|
|
|
.. code-block:: python
|
|
|
|
app.send_message(
|
|
chat_id="haskell",
|
|
text=(
|
|
"**bold**, "
|
|
"__italic__, "
|
|
"[mention](tg://user?id=23122162), "
|
|
"[URL](https://docs.pyrogram.ml), "
|
|
"`code`, "
|
|
"```"
|
|
"for i in range(10):\n"
|
|
" print(i)```"
|
|
)
|
|
)
|
|
|
|
- HTML:
|
|
|
|
.. code-block:: python
|
|
|
|
app.send_message(
|
|
chat_id="haskell",
|
|
text=(
|
|
"<b>bold</b>, "
|
|
"<i>italic</i>, "
|
|
"<a href=\"tg://user?id=23122162\">mention</a>, "
|
|
"<a href=\"https://pyrogram.ml/\">URL</a>, "
|
|
"<code>code</code>, "
|
|
"<pre>"
|
|
"for i in range(10):\n"
|
|
" print(i)"
|
|
"</pre>"
|
|
),
|
|
parse_mode="html"
|
|
)
|
|
|
|
.. _Telegram Bot API: https://core.telegram.org/bots/api#formatting-options |