How to markdown nested list items in Bitbucket? – Dev

The best answers to the question “How to markdown nested list items in Bitbucket?” in the category Dev.

QUESTION:

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.

ANSWER:

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…).

ANSWER:

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.

ANSWER:

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

ANSWER:

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.