DEV Community

Cover image for Even if you don’t like Markdown, sometimes you don’t have a choice
Onepoint profile image Kosmik
Kosmik for Onepoint

Posted on • Originally published at jtama.github.io

Even if you don’t like Markdown, sometimes you don’t have a choice

#markdown #asciidoc #howtos

TL;DR; 

# 🔥
downdoc -o out.md README.adoc
Enter fullscreen mode Exit fullscreen mode

💀 Opinions 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. 😢

Saaad keanu crying about markdown flavours

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.adoc
Enter fullscreen mode Exit fullscreen mode

Or install it using mise:

mise use npm:downdoc@latest
downdoc -v
Enter fullscreen mode Exit fullscreen mode

All hail to ASCIIDOC !

Cover image by Charlotte May

Top comments (0)

Some comments may only be visible to logged-in visitors. Sign in to view all comments.