Text Formatting

Pyrogram, just like Telegram Bot API, supports basic Markdown and HTML formatting styles for text messages and media captions; Markdown 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:

**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:

<b>bold</b>, <strong>bold</strong>

<i>italic</i>, <em>italic</em>

<a href="proxy.php?url=http%3A%2F%2Fdocs.pyrogram.ml%2F">inline URL</a>

<a href="proxy.php?url=tg%3A%2F%2Fuser%3Fid%3D23122162">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:

  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:

  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"
  )