Do I need to wrap input in HTML?

Yes for now — supported tags are ` `, ` `, ` `, ` `, ` `, ` `, ` `, ` `, ` `. Plain text without tags passes through unchanged.

Will custom emoji (tg-emoji) be preserved?

Custom emoji wrappers are stripped to leave the fallback Unicode character. Full custom-emoji ID-to-image mapping is not implemented.

How are mentions handled?

@username mentions are preserved verbatim since Markdown has no mention syntax.

What about multiple entity overlaps?

Overlapping HTML tags (e.g. ` … `) are handled with nested Markdown syntax.

Can I send raw Telegram entities (JSON array)?

Not yet — the API accepts text only. Forward your messages with their HTML representation, or use @vustMarkdownBot in Telegram for native entity support.

Markdown · Telegram to MD

Convert Telegram-formatted HTML to Markdown

Paste the HTML form of a Telegram message — ``, ``, `<a>`, `<code>`, `<pre>` — and get clean Markdown. Telegram entity arrays (text_link, custom_emoji) are not yet supported; HTML wrapping is required.

Free · No signup · Instant

Input (TELEGRAM)

Free, no signup. Up to 1 MB per request.

Try in Telegram

Telegram HTMLCode blocks + linksBuilt for Telegram

Telegram to Markdown examples

Paste real Telegram in the left column, see the Markdown output on the right.

Forwarded message HTML

Project Update Status: <a href="https://example.com">Live</a>

Markdown

**Project Update** _Status:_ [Live](https://example.com)

Code block with language

<pre><code class="language-js">const x = 1;</code></pre>

Markdown

```js const x = 1; ```

Mention preserved

Ping @username for details

Markdown

Ping @username for details

How Telegram-to-Markdown conversion works

Paste Telegram HTML — Paste the HTML representation of your Telegram message into the input field.

Convert — Click Convert — supported tags are mapped to Markdown.

Copy — Copy the Markdown output or download as `.md`.

Telegram edge cases we handle

HTML required

This converter accepts HTML wrapping (``, `<a>`, `<pre>` with `class="language-X"`). Raw text + Telegram entity arrays are not yet wired through the API.

text_link rendered as `<a>`

A Telegram `text_link` entity rendered as `<a href="…">label</a>` converts to `[label](url)` Markdown link syntax.

code_block with language

Code blocks with `class="language-X"` preserve the language hint in fenced blocks (` ```X `).

Mention passthrough

@username mentions inside or outside HTML wrapping are kept as-is — Markdown has no native mention syntax.

Frequently asked questions

Related Tools

Convert HTML to Markdown

Paste any HTML — including Telegram-formatted text or rich-text from your editor — and get clean Markdown ready for Jekyll, Hugo, GitHub, or Notion. No signup, instant.

Convert Plain Text to Markdown

Normalize plain text into Markdown-ready paragraphs. Numbered and bulleted lists already in Markdown syntax pass through cleanly; auto-detection of headings, URLs, and code blocks ships in a future wave.

Convert Markdown to HTML

Render Markdown into clean semantic HTML — ready for blogs, emails, or static sites. Handles GFM tables, code fences with language hints, and frontmatter strip.

Process bigger files in @vustMarkdownBot

500-character free conversions in chat — pay-as-you-go for longer text.

Open Telegram bot