8

Asciidoc is a text-based document format.

I tried the AsciiDoctor editor , but it requires installing Ruby and typing gem install asciidoctor, which scares away potential writers, especially the ones who use Windows.

Is there an extremely-easily installable Asciidoc editor for Windows?

Requirements:

  • Installable (or portable) via .msi or .exe
  • Zero configuration
  • Either WYSIWYG or code+preview is OK
  • Free
4

Hands down, the best for me is for now AsciidocFX : http://asciidocfx.com/

One package to install gives you an asciidoc editor with live preview, a toolbar with selected snippets, and a complete toolchain to produce the html, ebook or pdf files.

2

Atom Editor for Windows now has an easy installer. https://atom.io/

I think Atom Editor is the best AsciiDoc editor for Windows.

Add these two packages:

language-asciidoc for Syntax highlighting for AsciiDoc https://atom.io/packages/language-asciidoc If you save your files with the .adoc extention, this package will automatically highlight. If you prefer .txt extention, you can click "plain text" in lower-right-hand status bar and select AsciiDoc from the drop-down to get highlighting in a .txt file.

asciidoc-preview To show an HTML preview for the AsciiDoc content

Usage: Packages > AsciiDoc > Toggle Preview (Shift-Ctrl-A)

I also use the View > Toggle Soft Wrap to keep the text from being too wide

1

SynWrite is almost it: it's not shipped with Asciidoc lexer, of course (because Asciidoc format is not popular), but it's with lexer library dialog, in which you can copy Markdown lexer to "Asciidoc", and then edit this lexer copy for Asciidoc format.

  • What do you mean "fix copy for Asciidoc"? Is there a button to easily convert from Markdown to Asciidoctor format? – Nicolas Raoul Oct 3 '14 at 2:42
  • Changed text. Copy MD lexer to Asciidoc, and edit new one with lexer dialog, in app. – RProgram Oct 3 '14 at 2:45
1

If install chocalatey is not a problem for you, you can try Atom editor and the asciidoc-preview extension.

https://atom.io/packages/asciidoc-preview

There is also Brackets editor with also a asciidoc-preview.

https://github.com/asciidoctor/brackets-asciidoc-preview/

  • That's unfortunately too technical for my writers. (see first requirement) – Nicolas Raoul Oct 6 '14 at 4:12
  • Atom recently switched from chocolatey to conventional installation - you can download windows installer from atom webpage. You can also use asciidoctor Chrome extension for preview and any text editor for writing. – blablatros Jan 19 '15 at 11:23

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.