Once I felt that Markdown wasn't enough for documentation and Asciidoc seemed to be a good alternative.
I tried to rewrite it to AsciiDoc, but there was some unexpected ugly ess. Iirc e.g. lists. It bothered me so much, I switched back to markdown.
Today I reach for Typst when I need more than Markdown. Biggest caviar there is that html export is still wip.