This sample code accompanies the article on Practical Business Python. Refer to the article for more background and details on the rationale for the project.

This is a standalone script that will take a simple markdown file as input, convert the markdown to HTML and insert it in the template file.

Sample input files are included in order to illustrate the concept. The two input files are sample_doc.md which contains the content and template.html which contain the HTML structure that should render as a responsive email.

This script requires python >= 3.5 and the following dependencies:

• python-markdown2
• jinja
• premailer
• BeautifulSoup

Install them using pip or conda before running the script.

This is a standalone script that should be from the command line.

To see the help:

python email_gen.py --help

usage: email_gen.py [-h] [-t T] [-o O] doc

Generate HTML email from markdown file

positional arguments:
  doc         Markdown input document

optional arguments:
  -h, --help  show this help message and exit
  -t T        email HTML template
  -o O        output filename. Default is inputfile_email.html

Using the sample template file on the provided file:

python email_gen.py sample_doc.md

Will generate an inlined HTML file titled sample_doc_email.html that can be copied into an HTML email.

This simple script assumes that the markdown input file has header meta data that would be suitable for generating an article with pelican.

You will likely need to customize the template and the email_gen.py file for your own needs.

This software is released under the BSD 3-Clause License.