Issue #7132 new

Render AsciiDoc files (BB-1913)

Dobrosław Żybort avatarDobrosław Żybort created an issue


would be nice if you could render AsciiDoc files (after all it's written in Python).

File extensions to catch:

.ad, .adoc and .asciidoc

(and probably .ad.txt, .adoc.txt and .asciidoc.txt: )

Repo with samples:

Comments (24)

  1. laher

    +1, this feature gets my vote. Asciidoc is more appropriate (than e.g. Markdown) for authoring books and longer texts. Thanks

  2. jochenhinrichsen

    +1 While i like Markdown, Asciidoc outputs Docbook out of the box which opens up the whole nine yard of the publishing pipeline.

    As an implementation, i'd rather choose the newer Ruby based Asciidoctor instead of the older Python based Asciidoc.

  3. Dan Allen


    There's a Java API for Asciidoctor called AsciidoctorJ that encapsulates the use of JRuby. Bintray uses AsciidoctorJ to render AsciiDoc files. Asciidoctor runs fastest on JRuby anyway.

    Asciidoctor is also very secure for serve-rside usage. By default it runs in secure mode, which disables all file system access. You are free to enable the functionality from there that works best for you.

    AsciiDoc is gaining a lot of traction with big name authors lately, largely do to the innovation & advocacy coming out of the Asciidoctor project & community.

    GitHub uses Asciidoctor to render AsciiDoc, but it hasn't been upgraded past version 0.1.0 released in January. BitBucket could grab the reigns here by deploying 0.1.4 or 1.5.0.preview.1.

  4. TheSteve0

    +1 - we are storing the initial drafts of our book for O'Reilly here and it would be really nice as a paying customer if we could render the files

  5. Log in to comment
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.