Using AsciiDoc and Asciidoctor for Blogging

I'd like to see a comparison to Pandoc. The only reason he gives for all of this AsciiDoc mess is to get "Figure/Images with captions / Admonitions / Front-matter/Metadata / Footnotes", but 3 of those are available in Pandoc out of the box, and the fourth is easy to roll your own, as I have done. (Admonitions are just a div and an admonition class; certainly nothing so complex that you want an entire document tool chain just to do the same thing.)

When I started developing KeenWrite[1], I wanted a modular architecture[2] that made the choice of Markdown vs. AsciiDoc vs. DocBook irrelevant with respect to generating PDF or HTML files. The core idea of writing pure text documents is to separate content from presentation; the syntax, while important to some, shouldn&#x27;t sway the output format.<p>KeenWrite could integrate AsciidoctorJ and its XHTML5 back-end to support AsciiDoc in the future, if there was demand.<p>[1]: <a href="https:&#x2F;&#x2F;keenwrite.com&#x2F;" rel="nofollow noreferrer">https:&#x2F;&#x2F;keenwrite.com&#x2F;</a><p>[2]: <a href="https:&#x2F;&#x2F;gitlab.com&#x2F;DaveJarvis&#x2F;KeenWrite&#x2F;-&#x2F;raw&#x2F;main&#x2F;docs&#x2F;images&#x2F;architecture&#x2F;architecture.png" rel="nofollow noreferrer">https:&#x2F;&#x2F;gitlab.com&#x2F;DaveJarvis&#x2F;KeenWrite&#x2F;-&#x2F;raw&#x2F;main&#x2F;docs&#x2F;imag...</a>

There&#x27;s Asciidoctor.js that works nicely. I&#x27;m not so sure if any mainstream static site generator work well with it, but a lot of Asciidoc blogs do use custom implementations of it with simple scripts.

I use asciidoctor (via a simple filter for the nanoc static site generator[1]) for my weblogs. It works especially well for footnote-heavy essays[2] (at least compared to my attempts to use various markdown flavors for blogging), and also for code snippets[3]<p>1: <a href="https:&#x2F;&#x2F;nanoc.app&#x2F;" rel="nofollow noreferrer">https:&#x2F;&#x2F;nanoc.app&#x2F;</a> 2: example: <a href="https:&#x2F;&#x2F;americancynic.net&#x2F;log&#x2F;2018&#x2F;12&#x2F;3&#x2F;kivas_interest_rates&#x2F;" rel="nofollow noreferrer">https:&#x2F;&#x2F;americancynic.net&#x2F;log&#x2F;2018&#x2F;12&#x2F;3&#x2F;kivas_interest_rates...</a> 3: example: <a href="https:&#x2F;&#x2F;catswhisker.xyz&#x2F;log&#x2F;2020&#x2F;12&#x2F;7&#x2F;deranged_sinterklaas&#x2F;" rel="nofollow noreferrer">https:&#x2F;&#x2F;catswhisker.xyz&#x2F;log&#x2F;2020&#x2F;12&#x2F;7&#x2F;deranged_sinterklaas&#x2F;</a>

I really like asciidoc as an alternative to markdown, but it seems like the only preprocessors are written in JavaScript &amp; Ruby, which limits where&#x2F;how I can use it

I&#x27;ve been watching asciidoc for quite awhile. It looks excellent for its features, but its biggest problem is that every time I investigate it, it looks like in a year it&#x27;s gonna be usable.

Oh wow, just look at that fansy premble region. Not a div soup, but an actual HTML element, that gets read by a screen reader. May this new HTML backend soon become the default!

I use asciidoctor and jinja2 to generate PDF reports at work. Works pretty well, the syntax is a lot less cryptic than LaTeX.

Anyone done a bare-bones turnkey Asciidoc blog with Tufte CSS for semantic HTML including side margin footnotes ?