Blog
AsciiBinder AsciiDoc to Markdown to Docusaurus
Gabriel McGoldrick4 min readThe same Markdown exported as a Docusaurus 3 project. MDX is stricter than Markdown, definition lists need a plugin, and the base URL has to be split in two. Measured on 1,800 pages and a real build.
AsciiBinder AsciiDoc to Markdown to MkDocs
Gabriel McGoldrick4 min readThe same Markdown that builds the Astro site becomes an MkDocs Material project with one flag. What the exporter maps, what publishing 1,800 pages taught it, and a repo you can fork.
AsciiBinder AsciiDoc to Markdown to Astro
Gabriel McGoldrick5 min readTwo workflows that convert an AsciiBinder AsciiDoc corpus to Markdown and build it as an Astro site, on demand or weekly. Fork them and run them yourself; the OpenShift docs are the test corpus because they are the hardest one.
Mapping AsciiDoc includes and level offsets to Jinja
Gabriel McGoldrick2 min readIncludes map to Jinja natively. Level offsets do not exist in Jinja at all, so DogsBay extends it — and the extension has to be fence-aware.
Mapping AsciiDoc ifeval to Jinja
Gabriel McGoldrick1 min readifeval couples a parent document to its modules by comparing context strings. Jinja expresses the same coupling — including the unsetting that stops it leaking.
Mapping AsciiDoc conditionals to Jinja
Gabriel McGoldrick2 min readOne OpenShift source file serves Enterprise, OKD, ROSA and Dedicated. Translating ifdef to Jinja keeps audience selection a render-time choice instead of baking one variant in.
Mapping AsciiDoc variables to Jinja
Gabriel McGoldrick1 min readAttribute definitions become Jinja set statements, references become expressions — with one naming rule you have to apply, because hyphens mean subtraction.
Why Jinja is the right target
Gabriel McGoldrick2 min readAsciiDoc preprocessing and Jinja templating express the same three ideas — variables, conditionals, includes. That correspondence is what makes the conversion faithful.
Why existing AsciiDoc converters lose your structure
Gabriel McGoldrick2 min readAsciidoctor, DocBook and downdoc all resolve preprocessing away. The output compiles — and the modular logic that made the corpus maintainable is gone.
Converting AsciiDoc to Markdown
Gabriel McGoldrick2 min readA modular AsciiDoc corpus is not a folder of pages — it is fragments plus assembly instructions. Here is how to move it to Markdown without throwing that away.