Converts Markdown documents to Google+ posts

markdown, converter, googleplus, social
pip install markdown2social==0.3



The Markdown2Social utility converts simple Markdown documents to Google+ posts ready to be shared on the social network. There is room for writing output plugins for other target sites, but at the moment only Google+ is supported.

This is not an official Google product.


Long-form posts on social networks are more engaging than simply posting a bare link to the exact same content hosted elsewhere. However, composing long-form posts on social networks is not a pleasant experience because their editors are not designed to support long posts and because their formatting options are severely limited.

What if you could write that same content in a more durable and flexible format, say Markdown, and later export the text to the formats accepted by the networks of your choice? This would let you compose your posts using the myriad of editors that support Markdown, would let you store those posts in a version control system, and may even let you republish that same content directly on your site with ease.

This is exactly the goal of Markdown2Social: to let you store your articles' master copies in a version control system while providing a mechanism to extract a simplified version that can be shared in a social network. Does this work? For the most part yes, but there are obvious limitations; keep reading.


The latest version of Markdown2Social is 0.3 and was released on January 14th, 2016.

Download: markdown2social-0.3

See the release notes for information about the changes in this and all previous releases.


Using pip:

$ pip install -r requirements.txt
$ pip install markdown2social

From sources after cloning the tree from GitHub:

$ pip install -r requirements.txt
$ ./ install

See the detailed installation instructions for additional information.


  1. Use markdown2social as a filter or with explicit file names to generate a .gplus file:

    $ markdown2social < >doc.gplus
    $ markdown2social -o doc.gplus
  2. Open the .gplus file in your favorite editor.

  3. Copy the whole contents to the clipboard.

  4. Paste them into a new Google+ post.

  5. Hit share and voilà!