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

Add support for AsciiDoc format



    • 21
    • 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 November 2023

      Hi everyone,

      Thank you for your feedback. We appreciate your input and understand the importance of addressing our users' suggestions. Unfortunately, we don't have plans to address this specific suggestion in the next 12 months.

      However, I want to assure you that your feedback is valuable to us. Over the last 12 months we have successfully implemented many highly voted suggestions including code-owners, resolvable comments and auto-merge and our upcoming roadmap includes a number of other top voted suggestions including dark theme, draft pull requests and multi-line comments. For the most up-to-date information on what features are coming soon please visit our roadmap.

      Meantime, we hope that everyone might consider an established 3rd-party add-on - AsciiDoc Viewer for Bitbucket. 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.

      Once again, thank you for sharing your thoughts with us. Your feedback plays a crucial role in shaping the future of our product. We do continually review these priorities and will continue to do so over the coming year to determine when and how we might be able to address this idea. You can learn more about our prioritization process here.


      Sarah Bolt

      Product Manager - Bitbucket Data Center

      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
              230 Vote for this issue
              107 Start watching this issue