# Rich Message Formatting Options Source: https://core.telegram.org/bots/api#rich-message-formatting-options [Documentation index](../llms.txt) [Rich messages](inputrichmessage.md) support advanced structured formatting options like headings, lists, tables, media, block quotations, collapsible blocks, footnotes, and formulas. Telegram clients will render them accordingly. You can specify rich message content using [Markdown-style](rich-message-formatting-options.md#rich-markdown-style) or [HTML-style](rich-message-formatting-options.md#rich-html-style) formatting, or explicit [blocks](inputrichblock.md). Plain URLs, e-mail addresses, username mentions, hashtags, cashtags, bot commands, phone numbers, and bank card numbers are detected automatically. To disable automatic entity detection, pass *True* in the *skip\_entity\_detection* field. Note that Telegram clients will display an alert to the user before opening an inline link ('Open this link?' together with the full URL). When [Markdown-style](rich-message-formatting-options.md#rich-markdown-style) or [HTML-style](rich-message-formatting-options.md#rich-html-style) formatting is used, you can use links in the form `tg://photo?id=...`, `tg://video?id=...`, `tg://document?id=...`, and `tg://audio?id=...` instead of an HTTP URL to reuse previously uploaded files or upload a new file. ###### Rich Message Limits Rich messages are subject to the following limits: - Up to **32768 UTF-8 characters** in the rich message text, including custom emoji alternative text and formula source. - Up to **500 blocks**, including nested blocks, list items, ordered list items, table rows, quotation blocks, and details blocks. - Up to **16 levels** of nested formatting and blocks. - Up to **50 media attachments** in total. - Up to **20 columns** in a table. ###### Rich Markdown style To use this mode, pass rich message content in the *markdown* field. Use the following syntax in your message: ```` **bold text** __bold text__ *italic text* _italic text_ ~~strikethrough text~~ `inline fixed-width code` ==marked text== ||spoiler|| [inline URL](https://t.me/) [inline e-mail](mailto:user@example.com) [inline phone number](tel:+123456789) [inline mention of a user](tg://user?id=123456789) ![](tg://emoji?id=5368324170671202286) ![22:45 tomorrow](tg://time?unix=1647531900&format=wDT) $x^2 + y^2$ \#hashtag $USD +12345678901, card: 4242 4242 4242 4242, https://t.me t.me a@t.me /command @username all the text above was on the same line # Heading 1 ## Heading 2 ### Heading 3 #### Heading 4 ##### Heading 5 ###### Heading 6 Paragraph text ```python print('pre-formatted fixed-width code block written in the Python programming language') ``` --- - unordered list item * unordered list item + unordered list item 1. ordered list item 2. ordered list item - [ ] task list item - [x] completed task list item >Block quotation started > >Block quotation continued on the next line >Block quotation continued on the same line > >The last line of the block quotation ![](https://telegram.org/example/photo.jpg) ![](https://telegram.org/example/video.mp4) ![](https://telegram.org/example/audio.mp3) ![](https://telegram.org/example/audio.ogg) ![](https://telegram.org/example/animation.gif) ![](https://telegram.org/example/document.zip) ![](https://telegram.org/example/photo.jpg "Photo caption") ![](https://telegram.org/example/video.mp4 "Video caption") ![](https://telegram.org/example/audio.mp3 "Audio caption") ![](https://telegram.org/example/audio.ogg "Voice note caption") ![](https://telegram.org/example/animation.gif "Animation caption") ![](https://telegram.org/example/document.zip "Document caption") | Header 1 | Header 2 | |:---------|:--------:| | left | center | Text with a reference[^id1] and another one[^id2]. [^id1]: Definition of the first footnote. [^id2]: Definition of the second footnote. $$E = mc^2$$ ```math E = mc^2 ``` ## Example Nested Syntax Report for _Q1_ Intro with underlined text, ==marked text==, and $x^2 + y^2$. **Bold _italic underlined italic bold italic_ bold** In inline tags, nested **markdown** is parsed >Quote with **bold text, ~~strikethrough, and spoiler~~**, plus [a link](https://t.me/). - List item with `code`, superscript, subscript, and a footnote[^note] - Another item with **bold spoiler code** - Another item with ~~strikethrough and inserted text~~ | Metric | Value | |:-------|------:| | Speed | **42** ms | | Status | ready | [^note]: Footnote with _italic text_ and HTML underline. --- # Details blocks can contain Markdown content:
Summary with **bold text** ### Details heading - List item with _italic text_ - List item with spoiler
# Collages and slideshows can contain Markdown media blocks: ![](https://telegram.org/example/photo.jpg) ![](https://telegram.org/example/video.mp4) ![](https://telegram.org/example/photo.jpg) ![](https://telegram.org/example/video.mp4) ```` For formatting features that don't have Markdown syntax, use [HTML tags](rich-message-formatting-options.md#rich-html-style): ``` underlined text, underlined text subscript text superscript text
TitleContent
CaptionThe Author

Inline buttons: url user callback with the date 22:45 tomorrow and the custom emoji Mini App (private chats only) login (requires domain set up via @BotFather) inline inline 2 inline 3 Copy Disabled

url user callback Mini App (private chats only) login (requires domain set up via @BotFather) inline inline 2 inline 3 Copy Disabled ``` Additionally, you can use the following tag in [sendRichMessageDraft](sendrichmessagedraft.md): ``` Thinking... ``` Please note: - Rich Markdown is compatible with GitHub Flavored Markdown where possible and can contain arbitrary HTML. Supported rich message HTML tags are parsed as described in [Rich HTML style](rich-message-formatting-options.md#rich-html-style). - Media can be specified only as a separate block. - Media blocks support only HTTP and HTTPS URLs. - Media type is determined by the MIME type and the URL of the media. - In media syntax, the optional title after the URL is used as the caption; for example, ![](https://core.telegram.org/bots/url "Photo caption") displays “Photo caption” under the media. - Table cells can contain only inline formatting. - Formula source is treated as raw LaTeX. - Markdown isn't parsed inside block HTML tags other than
, and , therefore only HTML tags can be used there. - See [date-time entity formatting](formatting-options.md#date-time-entity-formatting) for more details about supported date-time formats. ###### Rich HTML style To use this mode, pass rich message content in the *html* field. The following tags are currently supported: ``` bold text, bold text italic text, italic text underlined text, underlined text strikethrough text, strikethrough text, strikethrough text inline fixed-width code marked text subscript text superscript text spoiler Reference inline URL inline e-mail inline phone number inline mention of a user in-document link Referenced text 22:45 tomorrow x^2 + y^2 #hashtag $USD +12345678901, card: 4242 4242 4242 4242, https://t.me t.me a@t.me /command @username all the text above was on the same line

Heading 1

Heading 2

Heading 3

Heading 4

Heading 5
Heading 6

Paragraph text

pre-formatted fixed-width code block
  print('pre-formatted fixed-width code block written in the Python programming language')
Footer text
  • unordered list item
  1. ordered list item
  1. ordered list item
  1. ordered list item with explicit number
  • Checked checkbox
  • Unchecked checkbox
Block quotation started
Block quotation continued
The last line of the block quotationThe Author
Expandable block quotation started
Expandable block quotation continued
Expandable block quotation continued
Expandable block quotation continued
The last line of the expandable block quotationThe Author
Photo captionPhoto credit
Video caption
Audio caption
Voice note caption
Animation caption
Document caption
Map caption
Header 1Header 2
Value 1Value 2
Table caption
ValueValue2Value3
Value4Value5Value6
Value7
TitleContent
TitleContent
E = mc^2

Inline buttons: url user callback with the date 22:45 tomorrow and the custom emoji Mini App (private chats only) login (requires domain set up via @BotFather) inline inline 2 inline 3 Copy Disabled

url user callback Mini App (private chats only) login (requires domain set up via @BotFather) inline inline 2 inline 3 Copy Disabled ``` Additionally, you can use the following tag in [sendRichMessageDraft](sendrichmessagedraft.md): ``` Thinking... ``` Please note: - Only the tags mentioned above are currently supported. - All numerical HTML entities are supported. - The API currently supports only the following named HTML entities: `<`, `>`, `&`, `"`, `'`, ` `, `…`, `—`, `–`, `‘`, `’`, `“` and `”`. - Use nested `pre` and `code` tags to define the programming language for a pre-formatted block. - Programming language can't be specified for standalone `code` tags. - Links `mailto:...`, `tel:...`, and `tg://user?id=...` are rendered as e-mail links, phone links, and inline mentions respectively. Other supported links are rendered as regular inline links. - Images, videos, and audio files can be specified only as separate media blocks. - Media blocks support only HTTP and HTTPS URLs. - An empty `` on its own creates an anchor that can be linked to with `...`. - In `
`, you can use `` tags to specify caption credit. - Use `...` to define referenced text that can be linked to with `...`. - The body of a `
` tag can contain rich message content. If the `open` attribute is specified, the block is expanded by default. - Formula source is treated as raw LaTeX. - See [date-time entity formatting](formatting-options.md#date-time-entity-formatting) for more details about supported date-time formats.