I'm trying to program (just for fun) a parser of asciidoc , but I'm a little confused. Where is the specification? It looks like there are not such asciidoc syntax but only asciidoc toolchains with a similar base syntax described clearly nowhere .
Reading users guide, examples, blogs and FAQs I can gather scattered information so I can "reverse engineering" for a parser, but with are lot of doubts. One of the supposed advantages of asciidoc over markdown is that there are not a lot of incompatible flavors. But it looks that the standarization of asciidoc comes from having only two "de facto" parsers: asciidoc.org and asciidoctor.org, (and now asciidoc3.org?) I guess asciidoc syntax is very simple, but thanks to its macros and brackets for paragraphs can be easily expanded to a very powerful system. So you depend upon a toolchain that defines a minimal usable types of paragraphs, but they are not standard, so another toolchain may define it other way. So, when I write an asciidoc document should I add "to be parsed with xxxxx"? -- You received this message because you are subscribed to the Google Groups "asciidoc" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at https://groups.google.com/group/asciidoc. For more options, visit https://groups.google.com/d/optout.
