Publish to Telegram plugin

English | Русский

Post notes directly to Telegram channels, groups, forum topics and personal messages, as your own account or as a bot. Standard and rich-text Telegram formatting, media and document attachments, and custom emoji are supported. Advanced publishing settings let you preview every message, schedule it, split a note into several posts, and edit what you already published.

Features

1. Publishing notes to any chat

Create presets for channels, groups, forum topics and personal messages. A single preset can hold several target chats, and you can search through your chat list after authorization or enter a @username or ID manually. A default preset lets you publish instantly with a single hotkey.

2. Four publishing methods

As your account, as a bot, or either of them with rich-text formatting. The method can be saved in a preset or an alternative one picked in the advanced publishing settings. You can also make a one-time post without a preset at all. Publishing is available with a hotkey, the command palette, the file context menu or the advanced publishing settings.

3. Full support for Telegram formatting

Not only standard formatting is supported, but rich-text elements as well: accordions, centered quotes, references, LaTeX formulas, maps, collages and slideshows. Attachments are available too — photo, video, audio, albums and documents. An emoji bar with search mirrors Telegram's categories and loads the custom packs added to your account. \split markers and rich-text formatting elements are inserted straight from the note editor's context menu.

4. Splitting notes into several posts

Publish several posts in a row from a single note and attach pre-written comments to them, which land in the post's discussion — or become replies to the message, if it is published in a group or in personal messages.

5. Preview and settings for every post

The advanced publishing settings show every message the way Telegram will render it, attachment placement and link preview included. For every post you can set: silent publishing, attachments below the text, the link preview's source and placement, scheduled publishing, sending when the recipient comes online, as well as specify whether it is published, edited or skipped.

6. Editing posts and comments

Edit posts and comments right from the note they were published from. To do that, enable automatic saving of post links to the note's properties.

A detailed user guide with setup walkthroughs and a description of every feature and every supported formatting option is available right in the plugin settings and can be opened from the command palette.

Installation

Option 1: Obsidian plugin store

1. In Obsidian settings open the tab "Community plugins" and click "Browse" button.

2. In the search bar type Publish to Telegram, click on the result, then "Install" and "Enable" buttons.

Alternatively, you can install the plugin by following the link to the community website: https://community.obsidian.md/plugins/publish-to-telegram

Option 2: BRAT plugin

If you want to test beta-versions of the plugin or use previous versions, you can do that with BRAT plugin:

1. Install BRAT plugin from the official Obsidian plugin store.

2. In the BRAT settings, find the “Beta plugin list” section and click on the “Add beta plugin” button.

3. In the window that appears, paste the link to the Publish to Telegram plugin repository: https://github.com/pan4ratte/obsidian-publish-to-telegram

4. Under “Select a version” choose the desired version and click the “Add plugin” button. The plugin will be automatically installed and will be ready to use.

User guide

To post notes to Telegram, you need to set up a preset. When creating a preset, you can choose any posting method as the primary one and use the others optionally, when necessary.

1. Publishing as an account

Important aspects of this publishing method:

• Posting as an account lets you use Telegram Premium features. Since July 2026 it can also post rich-text messages — choose the “Account + rich text” method — but that specifically requires Telegram Premium on the account (Telegram’s restriction). The plain “Account” method needs no Premium.

• The plugin supports logging into multiple accounts.

• Accounts can post not only to channels but also to groups, private chats, and bots without additional settings (provided you have permission to send messages).

Setup:

1. In the plugin settings, click the “Log In” button and sign in to your account. You can authorize using a phone number or a QR code. Your sessions are stored locally in encrypted form in your Obsidian Keychain.

2. Create a new preset, and under “Select primary publishing method,” choose “Account” or “Account + rich text.”

3. In the option that appears, select one of your authorized accounts.

4. Under “Use secondary publishing methods,” check the box if you want to post as a bot when necessary. You can change this setting at any time.

5. If the “Use secondary publishing methods” option is selected, choose previously added bot from the list that appears (see below for instructions on how to add a bot)

6. Click on the search field to load the list of chats for the selected account, and choose one or more target chats. Alternatively, enter @username or ID manually. You can get the @username or ID of any chat from @userinfobot.

Now you can post notes to Telegram using your preset’s name via the command palette, the note’s context menu, or keyboard shortcuts.

2. Publishing as a bot

Important aspects of this publishing method:

• Posting as a bot allows you to use rich-text formatting, but does not allow you to use Telegram Premium features due to Telegram's restrictions.

• You can add multiple bots to the plugin.

• Without additional configuration, bots can only post messages to channels (provided the bot is added to the channel, has admin rights, and is allowed to send messages).

  • To send messages to groups, you must disable the “Group Privacy” option in the @BotFather mini-app in the bot’s settings.
  • To send messages to other bots, you must enable the “Bot to Bot Communication Mode” option in the @BotFather mini-app in the bot's settings.
  • Bots cannot send messages to users unless the user has initiated a chat with that bot.

• The bot can optionally post text with standard formatting, without rich-text formatting.

Setup:

1. In the plugin settings, click the “Add bot” button, and in the window that appears, click “Open @BotFather”.

2. In the chat that opens, follow the instructions to create your own bot and copy its token.

3. Paste your bot’s token into the corresponding field in the plugin and click “Save.” Your bot tokens are stored locally in encrypted form in your Obsidian Keychain.

4. Create a new preset, and under “Select primary publishing method,” choose either “Bot” or “Bot + rich text.”

5. In the menu that appears, select one of your saved bots.

6. Under “Use secondary publishing methods,” check the box if you want to post as an account when necessary. You can change this setting at any time.

7. If the “Use secondary publishing methods” option is selected, choose a previously authorized account from the menu that appears (see above for instructions on how to authorize).

8. Click on the search field to load the list of chats for the selected account and choose one or more target chats. Alternatively, enter @username or ID manually. You can find the @username or ID of any chat using @userinfobot.

Now you can post notes to Telegram using your preset’s name via the command palette, the note’s context menu, or keyboard shortcuts.

3. Standard formatting

Standard formatting is available for posts made via the “Account” and “Bot” methods. All standard Telegram formatting elements are supported, as well as some additional ones:

Code block

3.1 Omitting text from a post

In addition to the formatting that will be reflected in the Telegram post, you can use the comment syntax <!-- hidden text --> or %% hidden text %% to add information to your notes that will not be included in the post content when it is published.

3.2 Splitting the note into multiple posts

You can also use the special command <!-- \split --> or %% \split %% to split the text of your note into separate posts. How the feature works:

• When you use the command, the plugin publishes all posts at the same time.

• Attachments (see below), including pre-written comments, must be placed before the split command, which marks the end of the post.

• After a split note is published, if link saving to the note's properties is enabled in the settings, the link to each post is written inside its \split command — for example %% \split t.me/channel/123 %%. If the last post has no command, one is added automatically.

• When you republish the same note, the new links are written too — for example %% \split t.me/channel/1 | t.me/channel/2 %%. When editing posts, the plugin relies on these links.

• You can insert the %% \split %% command into the text with the Insert post split marker command in the note's editor context menu.

• In the advanced publishing settings, a split note shows a preview of every post with its own row of publishing settings and lets you choose which posts to publish.

3.3 Attachments

Media, album (groups of media) and document attachments are supported. To attach a file to your post, use any of the standard Obsidian embed syntax options:

![[some-book-file.pdf]]

![](some-media-file.jpg)

!(some-video-file.mp4)[]

You can also embed files with external web-link embeds:

![](https://telegram.org/example/photo.jpg)

Currently supported formats:

Audio files (.mp3, .ogg, .m4a, .wav, .flac) are supported only inside a rich-text message — see Rich-text formatting below.

One post per publish (classic methods). The “Account” and “Bot” methods send your attachments as a single Telegram message — a photo/video album, or a document album. If your attachments can't fit in one message, the whole post is refused with an error (nothing is sent in fragments). This happens when you combine things Telegram can't group in one album (an album together with an animation/GIF or a document, or several GIFs), when an album would exceed 10 items, and — on the “Account” method only — when you mix photos and videos in the same album (the “Bot” method handles that combination). To publish such a set, use a rich-text method (which places everything in one rich message) or split the attachments across separate posts.

4. Rich-text formatting

Rich-text formatting is available for posts made via the “Bot + rich text” and “Account + rich text” methods (the account method requires Telegram Premium). Telegram’s Rich Markdown is compatible with GitHub-Flavored Markdown, so the plugin passes your note’s Markdown through almost verbatim: everything listed under Standard formatting is supported, and the elements below render natively instead of being simplified (for example, headings keep all six levels instead of collapsing to a single bold style).

print("hi")

4.1 Auto-detected entities

Telegram automatically detects and links several kinds of inline text — you don’t need any special syntax, just type them:

#hashtag, $USD (cashtag), @username, /command, phone numbers, and bank-card numbers.

A #hashtag is written exactly as in Obsidian; the plugin escapes it automatically so Telegram renders it as a clickable hashtag rather than a heading.

4.2 Advanced elements

Because Rich Markdown may contain arbitrary HTML, you can also write Telegram’s rich-message tags directly in your note for elements that have no Markdown shorthand. The full set of supported tags and attributes:

Inline formatting

Links, anchors & references

Block elements

Media (HTTP(S) URLs only)

Tables

HTML entities

• All numerical HTML entities (e.g. ').
• Named entities: <, >, &, ", ',  , …, —, –, ‘, ’, “, ”.

Note:

• In a ”Bot + rich text” post, inline media must be an HTTP(S) web link — the Bot API can’t upload a local file into a rich message, so a local attachment is rejected with an error (attach it with the classic “Bot” method, or use a web URL).
• An ”Account + rich text” post can embed local media too: photos, videos, GIFs and audio (.mp3, .ogg, .m4a, .wav, .flac) are uploaded and shown inline, right where you embed them, alongside any web-link media. Only local documents (e.g. .pdf, or .md embeds attached as files) can’t be embedded in a rich message.

4.3 Inserting elements from the context menu

You don't have to add this formatting by hand. Right-click in the note editor to open the "Rich-text formatting" submenu and choose an element to insert it into the text or to wrap the selected text.

5. The emoji bar

You can insert emoji, including emoji from custom Telegram packs using the emoji bar:

• To call the bar, run the "Publish to Telegram: Insert emoji" command from the command palette, or bind it to a hotkey such as Ctrl/Cmd + Shift + E.
• The search field at the top allows you to filter emoji by keywords in English and Russian.
• Category tabs — Recent, Smileys & people, Animals & nature, etc. — fully repeats native Telegram emoji bar.
• If your account has custom emoji packs saved, they will also load and you can insert them too. Animated emoji will be displayed as static, but will be sent correctly. To publish custom emoji you must have Telegram Premium.

6. Pre-written comments

You can pre-write one or more comments for your post that will appear in its discussion right after the publication. To use that feature:

1. In the plugin settings turn on the option "Treat .md embeds as post comments".

2. To prepare a comment for a post, use the ![[comment-file]] embed syntax. Only files with the .md extension are treated comments.

A couple of notes:

• If a comment on a post is published in a group or in personal messages, it will appear as a regular reply to a message.

• If you split the note into multiple posts (see above), you can attach the comments to each of the posts. To do that, place .md-embeds before the corresponding marker.

• A comment can carry attachments of its own: media and documents from the comment note are sent together with its text.

• Comments can be scheduled together with the post when publishing to a personal chat or a group. That is not possible in a channel with a discussion group: until the post is actually published there is nothing to reply to in the discussion, and the plugin will tell you so without sending anything.

• All comments are published with a slight delay.

7. Advanced publishing settings

You can open an advanced publishing settings window with command palette (Ctrl + P) by typing "Publish to Telegram: Publish with advanced settings". The advanced settings let you choose presets, configure the posts and see their preview.

7.1 Choosing a preset and a method

• The "Post without a preset" section lets you make a one-time post by picking the target chats, the author and the publishing method by hand, without saving a preset.

• Below it is the list of saved presets, and for each of them you can choose the default publishing method or an alternative one.

7.2 Post previews

A preview is shown for the post and for the pre-written comments. If the note is split into several posts, each of them is shown. The preview also lets you fine-tune every publication:

• Publish with a soundless notification.

• Move the attachments below the text.

• Set the link preview placement: below the text, above the text, or disabled.

• Send the message when the recipient comes online (only for the "Account" publishing methods).

• Schedule the publication (only for the "Account" publishing methods). Only comments have no date, they are published together with their post.

The "Comments follow post settings" option in the plugin settings repeats the changes of the post settings on its comments. A setting you change on the comment itself stays individual.

The preview shows the message the way Telegram will render it:

• When one of the classic publishing methods is selected, attachments are lifted out of the text and shown as an album above or below it — depending on the "Attachments below the text" setting.

• Click a link in the preview window to make it the source of Telegram's link preview (while Ctrl+Click opens the link). The resulting link preview is loaded right in the window.

Also, the publishing settings let you specify whether a post will be published, edited or ignored on publication (the last one is only available when there are several posts in one note).

7.3 Editing

Links to published messages are stored in the note's tg_posts and tg_comments properties, that are filled automatically if the corresponding option is enabled in the settings. You can also create them and fill manually.

An important note: a post is always edited in its original style — a rich-text post stays rich-text and a classic post stays classic, regardless of which preset you edit it with.

8. Limits

Standard Telegram posting limits apply to posts, sent via "Account" and "Bot" methods. A rich-text message may contain up to 32768 characters, 500 blocks, 16 levels of nesting, 50 media attachments, and 20 table columns. More about limits: https://limits.tginfo.me/

I also highly recommend my other plugin, Advanced Word Count, that allows you to create detailed presets for word counting in notes and offers significantly greater functionality, compared to the standard Obsidian word counter. This plugin can be easily configured to count characters exactly the same way Telegram does: its plugin extension store includes ready-made presets for Telegram.

About the Author

My name is Mark Ingram (Ingrem), I am a Religious Studies scholar. Apart from my main area of study (Protestant Political Theology in Russia), I teach the subject "Information Technologies in Scientific Research", a unique course that I developed myself from scratch. This plugin helps me in my studies and I use it in my teaching, as well as other plugins that I develop and that you can find on my GitHub profile.

Hello to every student that came across this page!

Huge thanks to Egor Gvozdikov, who wrote the first lines of code for this project and made numerous valuable commits.

In compliance with the Obsidian community guidelines, all external network calls should be disclosed in the plugin README and only made with user knowledge. This plugin makes network calls only to t.me