We had a 2-person board game convention this week :)

-mouser (July 10, 2019, 11:50 AM)

Awesome!

When's the next one?

There are no real good AsciiDoc editors, unless you know the syntax by heart.

-Shades (July 09, 2019, 11:37 AM)

As an Asciidoc newbie, I surely don't.  Here's one thing I found tricky to figure out:

https://mrhaki.blogspot.com/2017/10/awesome-asciidoctor-use-only-block-as.html

Do you happen to know of a list of 'gotchas' or other such not-so-obvious things?

Markdown has more mature editors,

Although there are so many varieties of "Markdown"...btw, do you think CommonMark will significantly improve this situation?

but it is cumbersome to create documentation in those and then do a conversion.

Indeed.

AsciiDocFX is currently the best of the bunch.

At the time I used VSCode v1.32 with the extension: AsciiDoc v2.7.6 from João Pinto (your first link). It is not bad, but the missing "link" between source section and the visualization section is a very big deal for me, as some pretty big documents need to be processed by me. Makes it way too easy to lose track of where you are and you'll start wasting time doing that instead of creating content/documentation.

Wow, double-clicking in the extension (seems to work better for me now) has some very odd behavior indeed.  It's nice that AsciidocFX seems to work appropriately in that regard.

The extension from your second link doesn't even appear in the extension tab of VSCode here in Paraguay (assuming there is some geo-policy present in the VSCode extension marketplace).

Doesn't seem like much of a loss, as, although it installed here, not much luck in getting it to work :(

Now I have made a batch script that helps me to automatize the conversion of all Word documents to AsciiDoc in any given folder (and its siblings). While that makes converting an existing document collection a whole lot easier, it isn't that fast and after conversion you still need to check if the converted documents have the same layout as the original and/or fix possible "glitches".

Perhaps someday something better will show up at:

https://asciidoctor.org/docs/editing-asciidoc-with-live-preview/

Congratulations!

Wishing you health, happiness, peace, and luck together :)