Email Block

approved

by joleaf

Render an email code block.

40 stars7,063 downloadsUpdated 4mo agoMIT
View on GitHub

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:

ParameterDescriptionValuesRequired
toThe main receiver of the mail. Multiple receiver seperated by ",".String / List of Strings
ccThe cc receiver of the mail. Multiple receiver seperated by ",".String / List of Strings
bccThe bcc receiver of the mail. Multiple receiver seperated by ",".String value / List of Strings
subjectThe subject of the email. Plain text or combined text with variablesString valuex
body (1)The body of the email. Plain text or a link to a [[NoteFile]] (2).String valuex
showmailtoShow the "mailto" link after the mail body.true/false (Default: true)
variablesA map of placeholder variables.YAML Object
fromA from field (only for documentation).String value
dateThe date/time the mail was sent (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

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.