diff --git a/Text-Formatting.md b/Text-Formatting.md new file mode 100644 index 0000000..62727e4 --- /dev/null +++ b/Text-Formatting.md @@ -0,0 +1,47 @@ +Pyrogram, just like [Telegram Bot API](https://core.telegram.org/bots/api#formatting-options), supports basic Markdown formatting for messages; it 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**. + +Here is the complete syntax you can use when sending or editing messages: + +
+**bold text**
+
+__italic text__
+
+[inline URL](http://www.example.com/)
+
+[inline mention of a user](tg://user?id=123456789)
+
+`inline fixed-width code`
+
+```block_language
+pre-formatted fixed-width code block
+```
+
+ +## Code snippets + +- Inline entities (bold, italic, ...): + + ``` python + client.send_message( + chat_id="me", + text="**bold**, __italic__, [mention](tg://user?id=23122162), [url](https://pyrogram.ml), `code`" + ) + ``` + + **Note:** Mentions are only guaranteed to work if you have already contacted the user. + +- Code blocks: + +
+  client.send_message(
+      chat_id="me",
+      text=(
+          # Code block language is optional
+          "``` python\n"
+          "for i in range(10):\n"
+          "   print(i)\n"
+          "```"
+      )
+  )
+  
\ No newline at end of file