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?

I opened a ticket: https://sourceforge.net/p/retext/tickets/113/ — MountainX, Mar 10 '14 at 01:35

score 8 · Answer 1 · edited Apr 13 '15 at 11:29

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

edited Apr 13 '15 at 11:29

A.B.

89,123
21
245
323

answered Jun 10 '14 at 16:43

Rahman Usta

181
1
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 05 '17 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 '18 at 20:17

score 4 · Answer 2 · answered Aug 18 '14 at 10:02

4

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

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

answered Aug 18 '14 at 10:02

Anthonny Quérouil

41
1

atom.io looks exciting. I'll check it out. Thanks – MountainX Apr 13 '15 at 20:48
1

asciidoc-preview for atom does not support PlantUML that makes it useless. – Stanislav Berkov Feb 15 '16 at 14:53

score 3 · Answer 3 · answered Mar 14 '19 at 21:07

3

Visual Studio Code also comes with a nice AsciiDoc plugin:

answered Mar 14 '19 at 21:07

Foad

833
6
9

This plugin also uses AsciiDoctor.js. – MountainX Mar 15 '19 at 18:38

Mogztter · Answer 4 · 2019-10-20T13:44:02.927

3

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

Install it for either Chrome or Firefox.
For Firefox, you'll need to download the latest xpi file (link on the README).
For Chrome, you'll likely want to enable Allow access to local file URLs under the extension options.
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).

edited Oct 20 '19 at 13:44

answered May 04 '14 at 09:28

Mogztter

131
3

New version of AsciiDoctor.js is found here: https://github.com/asciidoctor/asciidoctor-browser-extension – MountainX Mar 15 '19 at 18:32

score 1 · Answer 5 · answered Apr 13 '15 at 10:41

1

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

answered Apr 13 '15 at 10:41

Mandar Vaze

181
1
1
5

Should we trust Adobe to support Ubuntu going forward? – MountainX Apr 13 '15 at 20:46
1

It is an opensource project. Code available on github [here](https://github.com/adobe/brackets) Here is the [License](https://github.com/adobe/brackets/blob/master/LICENSE) – Mandar Vaze Apr 15 '15 at 06:30

score 1 · Accepted Answer · edited Jun 25 '23 at 14:08

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.

edited Jun 25 '23 at 14:08

Sergey Ushakov

273
2
8

answered Aug 22 '17 at 10:57

Falko Menge

637
6
11

Editor with live preview for AsciiDoc

6 Answers6