Even if you don't like MD, sometimes you don't have a choice
TL;DR;
downdoc -o out.md README.adocOpinions are my own. I may have to exagerate them for obvious narrative reasons.
Yes, you hate Markdown, and yet it seems to spread like a disease.
Yet, textual format documentation is an absolute necessity for us developers, and I am sure you already have found your challenger. I am talking, of course, about ASCIIDOC
Guess you would not be here if you hadn’t.
But there are some cases where you just don’t have a choice and have to produce Markdown. 😢
You are not doomed.
It seems that Dan Allen, father of Asciidoctor, agrees with you 100%.
Strange, isn’t it?
Anyway, he also fathered Downdoc… That name is absolutely marvelous, and here is its headline:
Rapidly down-converts AsciiDoc to Markdown.
You can either use npx to use it :
npx downdoc -o out.md README.adocOr install it using mise:
mise use npm:downdoc@latest
downdoc -vAll hail to ASCIIDOC
All images are free to use.[1]
