How to markdown nested list items in Bitbucket?

Html ListsMarkdownBitbucketNested Lists

Html Lists Problem Overview


I'm trying to see my markdown nested list items rendered with corresponding indentation when viewed in a browser live from the Bitbucket pages. But I can't figure out how it works even when using their examples (updated):

* Item 1
* Item 2
* Item 3
  * Item 3a
  * Item 3b
  * Item 3c

It ignores indentation for items 3a-c:

bitbucket rendered list

I want it to look like this (syntax works perfectly fine on SE and Github):

SE rendered list

Their list in list example is particularly unacceptable:

1. Step 1
2. Step 2
3. Step 3
   * Item 3a
   * Item 3b
   * Item 3c

list in list on bb

Here's a repo I set up just for this.

Html Lists Solutions


Solution 1 - Html Lists

Use 4 spaces.

# Unordered list

* Item 1
* Item 2
* Item 3
    * Item 3a
    * Item 3b
    * Item 3c

# Ordered list

1. Step 1
2. Step 2
3. Step 3
    1. Step 3.1
    2. Step 3.2
    3. Step 3.3

# List in list

1. Step 1
2. Step 2
3. Step 3
    * Item 3a
    * Item 3b
    * Item 3c

Here's a screenshot from that updated repo:

screenshot

Thanks @Waylan, your comment was exactly right.

Solution 2 - Html Lists

Possibilities
  • It is possible to nest a bulleted-unnumbered list into a higher numbered list.
  • But in the bulleted-unnumbered list the automatically numbered list will not start: Its is not supported.
  • To start a new numbered list after a bulleted-unnumbered one, put a piece of text between them, or a subtitle: A new numbered list cannot start just behind the bulleted: The interpreter will not start the numbering.
In practice
  1. Dog
  2. German Shepherd - with only a single space ahead. 2. Belgian Shepherd - max 4 spaces ahead.
  • Number in front of a line interpreted as a "numbering bullet", so making the indentation. * ..and ignores the written digit: Places/generates its own, in compliance with the structure. * So it is OK to use only just "1" ones, to get your numbered list. * Or whatever integer number, even of more digits: The list numbering will continue by increment ++1. * However, the first item in the numbered list will be kept, so the first leading will usually be the number "1".
    1. Malinois - 5 spaces makes 3rd level already.
      1. MalinoisB - 5 spaces makes 3rd level already.
      2. Groenendael - 8 spaces makes 3rd level yet too.
      3. Tervuren - 9 spaces for 4th level - Intentionaly started by "55".
      4. TervurenB - numbered by "88", in the source code.
  1. Cat
  2. Siberian; a. SiberianA - problem reproduced: Letters (i.e. "a" here) not recognized by the interpreter as "numbering".
  • No matter, that it is indented to its separated line in its source code: The indentation is ignored here. 2. Siamese
  • a. so written manually as a workaround misusing bullets, unnumbered list.

Solution 3 - Html Lists

4 spaces do the trick even inside definition list:

Endpoint
: `/listAgencies`

Method
: `GET`

Arguments
:   * `level` - bla-bla.
    * `withDisabled` - should we include disabled `AGENT`s.
    * `userId` - bla-bla.

I am documenting API using BitBucket Wiki and Markdown proprietary extension for definition list is most pleasing (MD's table syntax is awful, imaging multiline and embedding requirements...).

Solution 4 - Html Lists

This worked for me in Bitbucket Cloud.

Entering this:

* item a
* item b
** item b1
** item b2
* item3

I've got this:

enter image description here

Solution 5 - Html Lists

Even a single space works

...Just open this answer for edit to see it.

>`Nested lists, deeper levels: ---- leave here an empty row

  • first level A item - no space in front the bullet character
  • second level Aa item - 1 space is enough
    • third level Aaa item - 5 spaces min
    • second level Ab item - 4 spaces possible too
  • first level B item`

Nested lists, deeper levels:

  • first level A item - no space in front the bullet character

  • second level Aa item - 1 space is enough

    • third level Aaa item - 5 spaces min
    • second level Ab item - 4 spaces possible too
  • first level B item

      Nested lists, deeper levels:
       ...Skip a line and indent eight spaces. (as said in the editor-help, just on this page)
      * first level A item - no space in front the bullet character
       * second level Aa item - 1 space is enough
           * third level Aaa item - 5 spaces min
          * second level Ab item - 4 spaces possible too
      * first level B item
    

Attributions

All content for this solution is sourced from the original question on Stackoverflow.

The content on this page is licensed under the Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.

Content TypeOriginal AuthorOriginal Content on Stackoverflow
QuestionJeff PuckettView Question on Stackoverflow
Solution 1 - Html ListsJeff PuckettView Answer on Stackoverflow
Solution 2 - Html ListsFrantaView Answer on Stackoverflow
Solution 3 - Html ListsgavenkoaView Answer on Stackoverflow
Solution 4 - Html ListsAAAView Answer on Stackoverflow
Solution 5 - Html ListsFrantaView Answer on Stackoverflow