Buttondown

approved

by caro401

Send your notes to your buttondown.email account as email drafts.

19 stars4,083 downloadsUpdated 5mo agoMIT
View on GitHub

Obsidian Buttondown Plugin

Buttondown is a tool for producing email newsletters. It likes emails written in Markdown, and has an API.

This plugin allows you to write drafts for your emails in Obsidian, then send them to Buttondown with a single command, ready for you to preview and send.

How to use

  1. Install the plugin through the Obsidian's community plugins browser.
  2. Enable the plugin in Obsidian.
  3. Fill in your API token in the settings. You can find your token here in your Buttondown settings
  4. Write an email in an Obsidian note
  5. Call the command "Create a new Buttondown draft from this note" from the Command Palette (Ctrl-P) to create a new draft in Buttondown, where the email subject is the filename of your note, and the email body is the content of your note
  6. See your drafts in Buttondown here, where you can edit and preview the draft, then schedule or send the email to your list.

Privacy and network usage

This plugin makes network requests to Buttondown's API (https://api.buttondown.email) when you use the command to create a draft. The following data is transmitted:

  • Your Buttondown API key (configured in settings)
  • The content of your note (email body)
  • The filename of your note (email subject)
  • Any images referenced in your note (uploaded to Buttondown's image storage)

All data is sent directly to Buttondown's servers over HTTPS. No data is collected, stored, or transmitted to any other third parties. The plugin does not include any telemetry or analytics.

You must explicitly invoke the "Create a new Buttondown draft from this note" command for any network requests to occur. The plugin does not transmit data automatically or in the background.

Support me

ko-fi

How to make a release

  • Update minAppVersion manually in manifest.json if required, then npm version patch, npm version minor or npm version major .
  • Create a tag that matches that version git tag -a 1.0.1 -m "1.0.1" && git push origin 1.0.1

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.