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!

Python text markup and conversion

Project Description

Pyth is intended to make it easy to convert marked-up text between different common formats.

Marked-up text means text which has:

  • Paragraphs
  • Headings
  • Bold, italic, and underlined text
  • Hyperlinks
  • Bullet lists
  • Simple tables
  • Very little else

Formats I initially want to support are:

  • xhtml
  • rtf
  • pdf (output)

These three formats cover web, Word / OpenOffice, and print.

Design principles

  • Ignore unsupported information in input formats (e.g. page layout)
  • Ignore font issues – output in a single font.
  • Ignore specific text sizes – support relative sizes (bigger, littler) only. Output in a single base size.
  • Have no dependencies unless they are written in Python, and work
  • Make it easy to add support for new formats, by using an architecture based on plugins and adapters.

Unit tests

The sources contains some unit tests (written using python unittest module) in the ‘tests’ directory.

To run the tests we can either run them individually as python script, either use python nose. If using nose then we just need to go into the tests directory and invoke nosetest from there (make sure that pyth module is in PYTHONPATH).

Release History

This version
History Node


History Node


History Node


History Node


History Node


Download Files

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

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(23.6 kB) Copy SHA256 Hash SHA256
Source None Jul 15, 2014

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Kabu Creative Kabu Creative UX & Design Google Google Cloud Servers Fastly Fastly CDN StatusPage StatusPage Statuspage DigiCert DigiCert EV Certificate