Red Hat Bugzilla – Bug 1029723
RFE - Support for Markdown input files
Last modified: 2017-01-09 05:19:20 EST
My understanding is that Publican's new support of Docbook 5 means that Publican has the capacity to support other input formats in a pluggable way. I'd like to put Asciidoc, or its extension Asciidoctor, forward as a potential target for support. Asciidoc is a lightweight markup language, a superset of Markdown, with additional features. It is similar to Restructured Text. Asciidoc and Markdown have both become very popular with developers who use Github, as Github has the ability to render the source files as HTML in the browser interface. Asciidoctor is being spearheaded by Red Hat engineers. Red Hat GSS use Markdown a great deal. O'Reilly and others are now using Markdown and Asciidoc, as well. I believe all four structured text syntaxes have more similarities with each other than differences. Because of the similarities, I've included them all in this RFE. Feel free to divide it out, though.
One bug, one feature. When you open one bug with lots of features it means I get to take my pick of which bits to do as part of the bug. It's entirely unfair but that's how we devs roll :D
For this bug I will do the subset of these that are covered by
Future bugs will then be addressed at adding missing formats to those two upstream projects.
[15:32] <rudi> On another subject, which text input format would you like added to Publican first?
[15:32] <misty> Asciidoc but I'll take Markdown as Asciidoc is a superset of it
Markdown it is!
Bumping to 4.2 due to extra work caused by PDFs.
This is a lot of work for questionable value given there are a lot of tools that convert markdown/asciidoc/etc to docbook.
IMO we'd be better off spending time making piping output from those tools work better if they are having any problems doing so.