Topic / migration
5 pages
- AsciiBinder AsciiDoc to Markdown to Astro
Two 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.
- AsciiBinder AsciiDoc to Markdown to Docusaurus
The 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
The 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.
- Converting AsciiDoc to Markdown
A 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.
- Why existing AsciiDoc converters lose your structure
Asciidoctor, DocBook and downdoc all resolve preprocessing away. The output compiles — and the modular logic that made the corpus maintainable is gone.