rst2blogger is a command line program for converting reStructuredText documents to HTML suitable for posting to It takes as input a single filename and an optional blog title. The input file is parsed with docutils to create HTML, and the HTML is uploaded as a draft to the specified blog. If the blogger account only has one blog, the name does not need to be specified.


The simplest way to install rst2blogger is using pip:

$ pip install rst2blogger

You can also download the latest release from the PyPI page and install it by hand:

$ tar zxf rst2blogger-*.tar.gz
$ cd rst2blogger*
$ python install



rst2blogger [-h] [-b BLOG] filename
-h Show the command help.
-b, --blog Specify the blog where the new post should be uploaded.
The name of the input reStructuredText file.


rst2blogger authenticates with the Blogger API interactively after parsing the input file.

Input File Format

The input reStructuredText file should have a single top-level heading to be used as the title of the post. That value is stripped from the HTML body of the post, but other headings and structures such as tables and lists are included.

Identifying Blogs

The -b and --blog options to the rst2blogger command take as argument the title of the blog to receive the new post. If the authenticated account only has access to one blog, it does not need to be specified on the command line. If a blog title is required but not provided, the program prints a list of the available blogs and exits with an error.



  • Add lxml dependency to the


  • Include fix from btbytes that removes lingering call to BeautifulSoup.
  • Add a couple of basic tests.


  • Initial public release


  • This tool started life as a script used by the Python Software Foundation Communications team for posting to the PSF blogs.

Indices and tables