Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

An in-browser RST viewer with live updating

Project Description

rstviewer is a simple program for editing a reStructuredText (RST) file. In fact, it’s being used to edit this file right now!



$ rstviewer file.rst

opens a new browser window containing an HTML representation of of file.rst. The browser window refreshes when file.rst is changed.


By default, rstviewer runs in quiet mode – no logging messages are emitted, so as not to interfere with editing in the console. The option -v, which can be specified multiple times, increases the verbosity level.


Practically nonexistent. The program creates an HTTP server which serves all files located in or beneath the directory containing file.rst. This is to facilitate the loading of images and other assets linked by the RST document. Although the server binds only to the local interface, this is still insecure. In short, do not use this program if you are concerned about security.


Python 3.5+ and a browser which supports WebSockets. (The package has been tested only on Chrome and Safari, thus far.)


Jonathan Terhorst <>


NPM package rst-live-preview, which I could not get running.

Release History

Release History

This version
History Node

History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
rstviewer- (16.8 kB) Copy SHA256 Checksum SHA256 Source Feb 9, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting