Uploaded image for project: 'Bitbucket Server'
  1. Bitbucket Server
  2. BSERV-4769

Add support for AsciiDoc format



    • 151
    • We collect Bitbucket feedback from various sources, and we evaluate what we've collected when planning our product roadmap. To understand how this piece of feedback will be reviewed, see our Implementation of New Features Policy.


      Atlassian status as of Jan 2022

      Hi everyone,

      Thanks to everyone for voting and commenting on this suggestion. Your input in the comments helps us understand how this affects you and what you're hoping to accomplish with Bitbucket Data Center.

      We spend a significant amount of time determining our product investments in Bitbucket Data Center. Unfortunately, we are not planning to address this suggestion in the next 12 months. In the last year, we have resolved many of the highly voted suggestions like Reviewer groups, Pull request templates, capability to enable/disable source branch deletion on merging pull requests and our upcoming roadmap includes a number of other top voted suggestions, including repository archiving. Please check out our public roadmap for more details on the coming soon and future items.

      Meantime, we hope that everyone might consider an established 3rd-party add-on - AsciiDoc Viewer for Bitbucket Server. Our ecosystem is an important aspect of the product, providing flexibility where people want different or additional functionality, and maintaining simplicity where they don't.

      I understand that this may be disappointing, but it’s important for us to be open, honest, and transparent with our customers. Product feedback is collected from many different sources and is evaluated when planning the product roadmap. You can learn more about our process here.


      Anton Genkin
      Product Manager - Bitbucket Data Center & Server

      Original description

      Currently Stash supports Markdown as markup language. It can be used in descriptions/comments and in README file. But other providers like Bitbucket, also offers the possibility to use AsciiDoc format as markup language in README file.

      In my opinion providing AsciiDoc support will a really improvement/step forward in Stash and its documentation engine because of the richness offered by AsciiDoc language to cite a few options (tables, fashion inner elements, TOC, ...).

      Currently there is one implementation in Java that convert AsciiDoc content to Html code. The library is called AsciidoctorJ, but also there are implementations for Ruby called Asciidoctor, and even for Javascript which is called Asciidoctor Js. All of them are under the umbrella of Asciidoctor.

      In case of AsciiDoc format, there are several accepted extensions like .ad, .adoc or .asciidoc, which differs from markdown where the extension is .md.


        Issue Links



              Unassigned Unassigned
              3f43acee93b1 alex soto
              224 Vote for this issue
              106 Start watching this issue