Do you find yourself writing technical blog posts in Markdown and exporting them to HTML? Do you end up writing GitHub Flavored Markdown and then exporting to blocks or something similar? I know I used to do that quite often. Thats the reason I created Propagandist.

Propagandist is a simple tool which will parse out your Markdown and convert it into HTML. The cool part is that every Code Snippet that it finds gets replaced with a Gist for it. This produces a central Gist with all the snippets that users can jump into. Propagandist is built on top Gost which is a simple wrapper for the GitHub Gist API. They were both written in Golang on one of my train rides (I feel very productive on plane and train rides for some reason).

Here is a simple guide on how to get up and running with Propagandist.


go get



  • -f=”” // REQUIRED
  • -o=”output.html” // Output filename.
  • -p=false // Determine if the Gist will be Public or Private, Private by Default
  • -n=”Name of the Gist” // Name of the GistFile generated
  • -d=”Description of Gist” // Simple Description

For example:

$ propagandist -f="" -o="publish.html"

And that will provide me with a ready to go WordPress markup. We use Embed GitHub Gist here at SendGrid, and therefore, Propagandist uses that format for the Gists, but it can be easily modified to work with different styles.

If you think this is a cool project and want more features added to it, you know where to find me! It was originally developed to make blogging easier for me. If it can help anyone out there, I’d be super happy 🙂

Disclaimer: This post was generated using Propagandist! (Inception ah)

Expert advice and insight about all things email including best practices tips, examples, and advice for marketers, developers, and everyone in between.