Skip to content

joleaf/obsidian-email-block-plugin

Repository files navigation

Email Block for Obsidian GitHub tag (latest by date) Release Obsidian Plugin Obsidian downloads

This plugin lets you plan small emails inside your Obsidian notes.

Install ..

.. automatically in Obsidian

  1. Go to Community Plugins in your Obsidian Settings and disable Safe Mode
  2. Click on Browse and search for "Email Block"
  3. Click install
  4. Toggle the plugin on in the Community Plugins tab

.. manually from this repo

  1. Download the latest release *.zip file.
  2. Unpack the zip in the .obsidan/plugins folder of your obsidian vault

How to use

Add the "email" code block into your note:

... with plain text as body content:

```email
to: info@randommail.com
subject: My Subject
body: "Hey info,

  here is some content"
```

... with a referenced note as body content:

```email
to: info@randommail.com
subject: My Subject
body: [[MyMail4711]]
variables:
  myvar: TestVar
```

You can use the variables parameter to replace placeholders in your body text with the variable values. To include a variable in the body text just add a placeholder {{myvar}}. Variables from fontmatter data can be used as well.

... with a body text after the yaml:

```email
to: info@randommail.com
subject: Hello World
---
Hi there,
this is my new body
Best!
JB
```

... you can use properties, like variables, on the subject or within the body:

```email
to: info@randommail.com
subject: reminder for {{name}}
---
Dear {{name}},
this is not a personal email.
Regards,
FI
```

Parameter

You can customize the view with the following parameters:

Parameter Description Values Required
to The main receiver of the mail. Multiple receiver seperated by ",". String / List of Strings
cc The cc receiver of the mail. Multiple receiver seperated by ",". String / List of Strings
bcc The bcc receiver of the mail. Multiple receiver seperated by ",". String value / List of Strings
subject The subject of the email. Plain text or combined text with variables String value x
body (1) The body of the email. Plain text or a link to a [[NoteFile]] (2). String value x
showmailto Show the "mailto" link after the mail body. true/false (Default: true)
variables A map of placeholder variables. YAML Object
from A from field (only for documentation). String value
  1. The body can be appended after the yaml with a "---" separation
  2. No formatting is supported (only new lines) (reason).

Example

Example

How to dev

  1. Clone this repo into the plugin folder of a (non-productive) vault (.obsidian/plugins/)
  2. npm i
  3. npm run dev
  4. Toggle the plugin on in the Community Plugins tab

Contributors

Thank you for your contributions!

Donate

Buy Me a Coffee at ko-fi.com