search

asciidoctor / asciidoctorj

:coffee: Java bindings for Asciidoctor. Asciidoctor on the JVM!
http://asciidoctor.org
Apache License 2.0
617 stars 172 forks source link

feature request: render asciidoc to markdown #1232

Closed travisfw closed 10 months ago

travisfw commented 10 months ago

Markdown being a common readable text format, why not support rendering asciidoc to markdown? Then when you need markdown for whatever non-asciidoc system, just render and paste it. I imagine it could be a lot easier to support than the other output formats.

mojavelinux commented 10 months ago

If it's something you need, then you are welcome to create it. Nothing is stopping you. But no one is just going to do it for you. That's now how OSS works. You need to be part of the solution.

If you want to use software that's already available, you can check out downdoc. It's written in JavaScript, so not currently available through Java/AsciidoctorJ. However, you could write a wrapper that calls it using a system command.

The alternative would be to create a converter for Asciidoctor or AsciidoctorJ that generates Markdown. If you need help with that, you can ask in the project chat.

travisfw commented 10 months ago

If it's something you need, then you are welcome to […] create a converter for Asciidoctor or AsciidoctorJ that generates Markdown. If you need help with that, you can ask in the project chat.

Great. I asked on Zulip.

mojavelinux commented 10 months ago

We'll continue the discussion there.

Btw, there's a Markdown converter/backend for AsciidoctorJ of sorts. It just happens to be called the leanpub converter because it generates Markdown of the Leanpub variant (because there isn't just one Markdown to target).

See https://github.com/asciidoctor/asciidoctor-leanpub-converter