Converts simple Markdown documents to Google+ posts
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
markdown2social
scripts
.gitignore
.travis.yml
AUTHORS
CONTRIBUTING
CONTRIBUTORS
INSTALL.md
LICENSE
MANIFEST.in
NEWS.md
README.md
distcheck.sh
requirements.txt
setup.cfg
setup.py

README.md

Markdown2Social

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.

Why?

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.

Download

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.

Installation

Using pip:

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

From sources after cloning the tree from GitHub:

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

See the detailed installation instructions for additional information.

Usage

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

    $ markdown2social <doc.md >doc.gplus
    $ markdown2social -o doc.gplus doc.md
  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à!