Skip to content
This repository has been archived by the owner on Nov 21, 2017. It is now read-only.


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Asciidoctor Firefox Addon (deprecated)

This project uses Asciidoctor.js to render AsciiDoc as HTML inside Firefox!


No longer actively maintained since Firefox now supports WebExtensions API 🎉

In the past, there were several toolsets for developing Firefox extensions, but by the end of November 2017, extensions must be built using WebExtensions APIs. Extensions written using WebExtensions APIs for Firefox are designed to be cross-browser compatible. In most cases it will run in Chrome, Edge, and Opera with few if any changes. They are also fully compatible with multiprocess Firefox.

The code base for Chrome, Chromium, Opera and Firefox is now available at


  1. Install the extension from the Firefox Add-ons site or from the GitHub latest release page. When you download the xpi file, if Firefox downloads it instead of directly installing it, just drag and drop it on Firefox

  2. Open local or remote .ad, .adoc, .asc, .asciidoc file in Firefox

  3. Click on the Asciidoctor Live Preview button in the toolbar (button with an A icon) to activate or deactivate the rendering.

asciidoctor preview enabled
Figure 1. An asciidoc file opened in firefox with HTML preview
asciidoctor preview disabled
Figure 2. An asciidoc file opened in firefox without HTML preview

Local build

To manually build the extension bundle (.xpi) from the source you need to install jpm.

$ npm install jpm -g

Then execute the command jpm xpi from the add-on’s directory:

$ jpm xpi

This command will produce an .xpi file. You can simply drag and drop it on Firefox to install the Add-on.

Copyright © 2013 Guillaume Grossetie. Free use of this software is granted under the terms of the MIT License.

See the LICENSE file for details.


🐺 An add-on for Mozilla Firefox that converts AsciiDoc files to HTML directly in the browser using Asciidoctor.js.



Code of conduct





No packages published