Editor with live preview for AsciiDoc

Question

I'm looking for something like ReText, but for AsciiDoc.

The closest I have found is this relatively complex solution (or here) involving Ruby, guard, guard-shell, rb-inotify, asciidoctor, Epiphany (or another browser with LiveReload).

I'll do all that if it is the best option. But I was looking for just a simple solution, along the lines of a ReText for AsciiDoc.

I also heard that O'Reilly has some tools (e.g., the Atlas wiki interface), but I'm not submitting my documents to O'Reilly. (Atlas looks cool and I'd consider using it if I could do so privately.)

Anyone have another suggestion?

Solution 1

AsciiDoctor provides a nice Overview of Editing AsciiDoc with Live Preview.

It includes details on how to setup many of the tools mentioned here, e.g. AsciidocFX, Atom, Brackets and IntelliJ.

Solution 2

You can use AsciidocFX on any platform.

There are many features:

• Real-Time Preview
• Multi-platform (Windows, Mac, Linux ..)
• Creating Asciidoc Books
• Creating Markdown Books
• Creating PDF, HTML, Epub, Mobi, Docbook
• Epub Viewer
• External Browser Support
• Table Generator
• MathJax Extension
• PlantUML Extension
• Filesystem Tree Extension
• JavaFX Charts Extension

Solution 3

You can also use atom.io with the plugin asciidoc-preview :

http://www.youtube.com/watch?v=R9o-0J2YKZ4

Solution 4

You can use the Asciidoctor.js Live Preview browser extension to render AsciiDoc (.ad, .adoc, .asc, .asciidoc) as HTML.

1. Install it for either Chrome or Firefox.

2. For Firefox, you'll need to download the latest xpi file (link on the README).

3. For Chrome, you'll likely want to enable Allow access to local file URLs under the extension options.

4. Then either point your browser at a remote AsciiDoc URL or create a new file locally (e.g. helloworld.adoc), enter some text in it with your favorite editor, and then point your browser to it (e.g. file:///home/ggrossetie/helloworld.adoc).

Solution 5

Visual Studio Code also comes with a nice AsciiDoc plugin:

View more solutions

Comments

[MountainX]

I opened a ticket: sourceforge.net/p/retext/tickets/113

[MountainX]

Should we trust Adobe to support Ubuntu going forward?

[MountainX]

atom.io looks exciting. I'll check it out. Thanks

[Jalo]

It is an opensource project. Code available on github here Here is the License

[Stanislav Berkov]

asciidoc-preview for atom does not support PlantUML that makes it useless.

[wisbucky]

That looks pretty good. Can it edit in Preview mode? I'm looking for an asciidoc editor that can do WYSIWYG editing (not just a live preview).

[Dimitar II]

Unfortunately, the AsciidocFX editor is very slow. Even with turned off preview, I have to wait the typed letters to appear. Selecting words is even slower.

[MountainX]

New version of AsciiDoctor.js is found here: github.com/asciidoctor/asciidoctor-browser-extension

[MountainX]

This plugin also uses AsciiDoctor.js.