8

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?

1

6 Answers 6

8

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
2
  • 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).
    – wisbucky
    Jun 5, 2017 at 20:33
  • 1
    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.
    – Dimitar II
    Jan 23, 2018 at 20:17
4

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

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

2
  • atom.io looks exciting. I'll check it out. Thanks
    – MountainX
    Apr 13, 2015 at 20:48
  • 1
    asciidoc-preview for atom does not support PlantUML that makes it useless. Feb 15, 2016 at 14:53
3

Visual Studio Code also comes with a nice AsciiDoc plugin:

enter image description here

1
  • This plugin also uses AsciiDoctor.js.
    – MountainX
    Mar 15, 2019 at 18:38
3

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).

1
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.

1

Brackets Editor has a AsciiDoc Preview Extension that I am using right now. Works well.

2
  • Should we trust Adobe to support Ubuntu going forward?
    – MountainX
    Apr 13, 2015 at 20:46
  • 1
    It is an opensource project. Code available on github here Here is the License Apr 15, 2015 at 6:30

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .