Asciidoctor Browser Extension

Enjoy AsciiDoc everywhere your browser goes with the Asciidoctor Browser Extension.

The Asciidoctor Browser Extension uses Asciidoctor.js to preview AsciiDoc files (.ad, .adoc, .asc, .asciidoc, and optionally .txt) as HTML inside Chrome, Brave, Firefox, Opera, Microsoft Edge and other Chromium browsers.

Project health:

Install

1. Install the Extension on your browser using the image links below.

   Chrome

   Firefox

   Opera

   Edge

   💡	You can also search your browser’s Web Store for the Asciidoctor.js Live Preview extension.

2. To preview local files on Chrome, Edge, Chromium, Brave or Opera browsers, you need to grant filesystem access to the extension:

   1. Type the URL chrome://extensions into the address bar and press Enter

   2. Type asciidoctor into the extension search bar then when the Asciidoctor Browser Extension block is visible, click its Details button

   3. Check Allow access to file URLs

      ℹ️	If the plugin does not view a local file, check the above setting.

3. You have now installed the extension, and can open local or remote .adoc, .ad, .asc, .asciidoc files in your browser

   Enjoy!

Next steps

If you want to learn more and explore the capabilities of the Extension, please read the User Manual.

Contributing

See the CONTRIBUTING.adoc file.

Changelog

See the changelog.adoc file.

Copyright

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

See the LICENSE file for details.