tg-md-msg
Markdown, meestal LLM-uitvoer, naar Telegram sturen zonder kapotte opmaak of handmatig escapen.

Een TypeScript-bibliotheek voor Telegram-bots die antwoorden in Markdown, meestal geschreven door een LLM. Ze maakt van de Markdown een bericht dat Telegram accepteert: zonder handmatig escapen, zonder opmaak die halverwege een antwoord breekt en zonder berichten die worden geweigerd om één verdwaald teken.
Ik schreef haar voor mijn eigen bot, die LLM-antwoorden zowel als gewone berichten verstuurt als als de nieuwe rich messages van Telegram.
Wat ze doet
Eén Markdown-tekst, elk formaat dat Telegram aanneemt:
- Entities: platte tekst plus een lijst opmaak-entities voor
sendMessage. Er is geenparse_mode, dus er valt niets te escapen. - Rich messages voor
sendRichMessage(Bot API 10.1+): echte koppen, tabellen, selectievakjes, formules, voetnoten en media. - MarkdownV2, voor de plekken die alleen een
parse_mode-string aannemen. - Telegraph-pagina’s, voor teksten die te lang zijn voor een chat.
Elk formaat heeft een splitter die lange antwoorden opdeelt in berichten binnen de limieten van Telegram, en streaminghelpers tonen een antwoord terwijl de LLM het nog schrijft, met de stopknop uit Bot API 10.3.
Gebaseerd op een Python-bibliotheek
Het is een TypeScript-port van telegramify-markdown, een Python-bibliotheek van sudoskys, en volgt de releases daarvan. Alles is overgezet behalve het tekenen van Mermaid-diagrammen.
Een native parser in Rust
De Markdown wordt geparst door pulldown-cmark, een CommonMark-parser geschreven in Rust. De Python-bibliotheek gebruikt dezelfde parser via haar Python-bindings; hier is hij met N-API gecompileerd tot een native Node.js-module. Het parsen gebeurt in native code, en de TypeScript-kant loopt alleen de events van de parser af en rendert ze. JavaScript-strings tellen UTF-16-code-units, net als de entity-offsets van Telegram, dus omrekenen van offsets is ook niet nodig.
Kant-en-klare binaries worden gebouwd voor zeven platforms: macOS (Intel en Apple silicon), Windows x64, en Linux x64 en arm64 met glibc of musl (Alpine). De installatie kiest de juiste; op andere platforms bouw je hem uit de broncode.
Getest tegen Telegram
Bovenop de port heeft ze meer dan 300 tests, en de live tests sturen echte berichten via de Bot API om te controleren dat Telegram ze accepteert. De uitvoer volgt de API van Telegram tot op de letter: rich messages gebruiken Telegrams eigen veldnamen (onbekende velden negeert Telegram zonder melding), het splitsen telt blokken en media zoals Telegram dat doet, en entity-offsets blijven kloppen na niet-Latijnse tekst. Ze is bij met Bot API 10.4.
Installeren
Ze wordt geïnstalleerd vanaf GitHub, niet uit het npm-register. Het commando, de vereisten en de opmerkingen per platform staan in de sectie Installation van de README.
import { convert } from 'tg-md-msg';
const { text, entities } = convert('**Hello** from `tg-md-msg`');
await bot.api.sendMessage(chatId, text, { entities });
Ze vereist Node.js 18 of nieuwer en is alleen ESM. Ze is open source (MIT): github.com/podgorniy/ts-md-msg.