Welcome, guest | Sign In | My Account | Store | Cart

Notice! PyPM is being replaced with the ActiveState Platform, which enhances PyPM’s build and deploy capabilities. Create your free Platform account to download ActivePython or customize Python with the packages you require and get automatic updates.

pypm install argot

How to install Argot

  1. Download and install ActivePython
  2. Open Command Prompt
  3. Type pypm install argot
 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
0.6 Available View build log
0.5.4 Available View build log
Windows (64-bit)
0.6 Available View build log
0.5.4 Available View build log
Mac OS X (10.5+)
0.6 Available View build log
0.5.4 Available View build log
Linux (32-bit)
0.6 Available View build log
0.5.4 Available View build log
Linux (64-bit)
0.6 Available View build log
0.5.4 Available View build log
Lastest release
version 0.6 on Jan 5th, 2011

Argot is a small set of extensions on the markdown markup language designed primarily for writing technical blog entries. The extensions are not "proper" markdown extensions; they are implemented as preprocessors that compile down into markdown or html syntax. In addition to markdown's regular syntax, which argot does not interfere with, argot provides these features:

You can install argot with pip:

pip install argot

You can fork argot from its hg repository:

hg clone http://bitbucket.org/jmoiron/argot/


argot requires markdown and pygments. The optional amazon link processor, disabled by default, requires lxml.

version 0.6 notes

Version 0.6 of argot adds some functionality to the argot script, allowing you to easily create full HTML documents (with pygments styling) from argot markup in one easy command.

Version 0.6 of argot is backwards compatible with version 0.5, but maintains the blockquote blocks which makes it incompatible with versions previous to 0.5. If you are using a version older than 0.5 and wish to upgrade, please consult the README.rst file in 0.5 for a full list of incompatabilities.

moin-style highlighted code blocks

In markdown, code blocks are blocks of text one level of indentation removed from the body text. However, when dealing with more primative browser input mechanisms, indenting lots of text can be problematic (as tab often shifts input focus). In addition to allowing for this convention, argot implements moin/tracwiki style code blocks that feature syntax highlighting via pygments.


The general syntax is '{{{' followed by an optional shebang and desired pygments parser, followed by your code block, and bookended with '}}}':

    ... code ...

By default, if no parser is provided, argot uses pygments to try and guess what language is being used. It falls back to the plain text lexer. If you want to force the text lexer, use a lexer of text.

blockquote blocks

Like the moin-style highlighted code blocks, blockquote blocks are primarily intended for easy cut/paste insertion of quoted blocks into a body.


The syntax for blockquote blocks is similar to that of the code blocks, except that parens are used instead of braces:

((("citation url"
quoted text

The quoted text is converted to HTML via regular markdown syntax rules. Nesting blockquote blocks is not supported. The optional citation url can be surrounded in single quotes (') or double quotes (").

argot command line tool

Like markdown, argot ships with a command line tool that will convert text files to html called argot. It's usage is:

Usage: argot [options] file

  --version             show program's version number and exit
  -h, --help            show this help message and exit
  -r REFERER, --referer=REFERER
                        http referer for google link parser
  -d, --document        render as full html document
  -t TITLE, --title=TITLE
                        title to use in HEAD (implies -d)
  -s STYLE, --style=STYLE
                        pygments style to use

With the -d option, argot will create a full HTML document with the specified pygments style (defaults to default).

Subscribe to package updates

Last updated Jan 5th, 2011

Download Stats

Last month:4

What does the lock icon mean?

Builds marked with a lock icon are only available via PyPM to users with a current ActivePython Business Edition subscription.

Need custom builds or support?

ActivePython Enterprise Edition guarantees priority access to technical support, indemnification, expert consulting and quality-assured language builds.

Plan on re-distributing ActivePython?

Get re-distribution rights and eliminate legal risks with ActivePython OEM Edition.