README file from
GithubDiscord Webhooks Plugin
Save your Discord webhooks and use them to send selected text from the editor/preview or send preset messages (including rich embeds) to your Discord server.
Features
➕ Add, edit, and delete Discord webhooks for easy reuse—no need to constantly enter webhook URLs.
🎯 Choose a default webhook for sending selected text directly from the editor or preview via the editor menu.
💬 Create, edit, and delete preset messages (including rich embeds) that can be sent through any saved webhook.
⚡ Send preset messages via Obsidian commands with one command per message (works great with the Buttons plugin).
How to use
Setting up webhooks
- Open the plugin settings.
- Click the
+icon to create a new webhook. - Create a Discord webhook (see the official guide) and copy its URL.
- Name your webhook in the modal window and paste the URL. The name makes it easier to identify (e.g., General for your
#generalchannel). - Click Save.
Choosing a webhook for selected text
- Open the plugin settings.
- If you haven't added a webhook yet, create one following the steps above.
- Select a webhook from the dropdown menu to use when sending selected text.
Note: If you delete the chosen webhook, you'll need to select a new one before sending selected text again.
Setting up messages
- Open the plugin settings.
- Click the
+icon to create a new message. - Name your message—this name will appear in the command palette.
- Select a webhook from the dropdown to send this message's payload.
- Provide a JSON payload compatible with Discord's message specification.
- Tools like Discohook are great for building and previewing JSON.
- Click Save.
Warning: If you delete the chosen webhook, the message will be deleted as well.
Sending content to Discord
Sending selected text
- Open any note (editor or preview mode).
- Select a chunk of text.
- Open the editor menu (top right) and choose Share selected text to Discord.
- The selected text will be sent as a webhook message.
Sending a saved message
- Open the Command Palette.
- Choose Discord Webhooks: Send [Message name] message to Discord.
- The preset JSON payload will be sent via the selected webhook.
Background and scope
This plugin was originally created for my D&D group while I'm DMing a Curse of Strahd campaign, so it focuses on a small set of features we actually use at the virtual table. I plan to keep it maintained (especially for future Obsidian updates) and fix bugs as they come up, but I don't expect to add new features unless they're something I personally need for the campaign.
Crafted by a human without the use of generative AI.