compose_email: Create the email message body

View source: R/compose_email.R

compose_emailR Documentation

Create the email message body


The compose_email() function allows us to easily create an email message. We can incorporate character vectors into the message body, the header, or the footer.


  body = NULL,
  header = NULL,
  footer = NULL,
  title = NULL,
  template = blastula_template


header, body, footer

The three layout sections for an email message (ordered from top to bottom). Markdown text can be supplied to each of these by using the md() text helper function. Alternatively, we can supply a set of ⁠block_*()⁠ calls enclosed within the blocks() function to take advantage of precomposed HTML blocks.


The title of the email message. This is not the subject but the HTML title text which may appear in limited circumstances.


Additional arguments to pass to the template function. If you're using the default template, you can use font_family to control the base font, and content_width to control the width of the main content; see blastula_template(). By default, the content_width is set to ⁠1000px⁠. Using widths less than ⁠600px⁠ is generally not advised but, if necessary, be sure to test such HTML emails with a wide range of email clients before sending to the intended recipients. The Outlook mail client (Windows, Desktop) does not respect content_width.


An email template function to use. The default is blastula_template().


An email_message object.


# Create a simple email message using
# Markdown-formatted text in the `body`
# and `footer` sections with the `md()`
# text helper function
email <-
    body = md(
## Hello!

This is an email message that was generated by the blastula package.

We can use **Markdown** formatting with the `md()` function.


The blastula team
  footer = md(
sent via the [blastula]( R package

# The email message can always be
# previewed by calling the object
if (interactive()) email

blastula documentation built on Sept. 24, 2023, 1:07 a.m.