Як розмітити вкладені елементи списку в Bitbucket?


173

Я намагаюся побачити, що мої розмітки вкладених елементів списку відображаються з відповідним відступом, коли їх переглядають у веб-переглядачі наживо зі сторінок Bitbucket. Але я не можу зрозуміти, як це працює навіть при використанні їхніх прикладів ( оновлено ):

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

Він ігнорує відступи для елементів 3a-c:

список виданих бітбукетів

Я хочу, щоб це виглядало так (синтаксис прекрасно працює на SE та Github):

SE надано список

Їх список у прикладі списку особливо неприйнятний:

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

список у списку на bb

Ось репо, яку я створив саме для цього.


6
Ви відступили чотири пробіли? Або менш?
Вейлан

Відповіді:


278

Використовуйте 4 пробіли.

# 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

Ось знімок екрана з оновленого репо:

скріншот

Дякую @Waylan , ваш коментар виявився абсолютно правильним.


4
Варто також зазначити, що в деяких випадках є хорошою практикою не нумерувати свої списки. Якщо вони призначені лише для читання у відтвореному вигляді, використовуючи "1." для кожного предмета вони призведуть до їх нумерації. Цього слід уникати, якщо ви намагаєтеся зберегти читабельність тексту.
Нільпо

1
Будь-яка причина, чому лінери починають пропонувати два пробіли для вкладеного вмісту списку?
Грег Хілстон

Я не міг зрозуміти, як це зробити в новому редакторі Atlassian, що вони розгортаються в лабораторіях. confluence.atlassian.com/doc/the-editor-251006017.html Але, можливо, це відповідь? confluence.atlassian.com/doc/…
Райан

у деяких реалізаціях використовуються чотири пробіли для блоків коду, тому це не вдалося використати для
Пабло

2
@PabloPazos це питання стосується конкретної реалізації Bitbucket, чого, напевно, хочеться.
Джефф

4

Можливості

  • Можна вбудувати купово-нумерований список у більш пронумерований список.
  • Але у списку з нумерованим номером список, який автоматично пронумерований, не запуститься: його не підтримується.
    • Щоб почати новий нумерований список після купово-нумерованого, покладіть фрагмент тексту між ними або підзаголовком: Новий пронумерований список не може починатися відразу за позначеним: Інтерпретатор не почне нумерацію.

на практиці

  1. Собака

    1. Німецька вівчарка - лише попереду єдине пробіл.
    2. Бельгійська вівчарка - максимум 4 місця попереду.
      • Число перед рядком інтерпретується як "куля нумерації", тому роблячи відступ.
        • ..і ігнорує написану цифру: Містить / генерує свою, відповідно до структури.
        • Тому добре використовувати лише "1", щоб отримати свій номерний список.
          • Або будь-яке ціле число, навіть більше цифр: Нумерація списку продовжуватиметься з збільшенням ++ 1.
        • Однак перший пункт у нумерованому списку буде зберігатися, тому першим ведучим зазвичай буде число "1".
    3. Малінойс - 5 просторів вже робить 3-й рівень.
      1. MalinoisB - 5 місць вже займає 3 рівень.
      2. Groenendael - 8 пробілів робить ще 3-й рівень.
        1. Тервурен - 9 просторів для 4-го рівня - Навмисно розпочато з "55".
        2. TervurenB - нумерується "88" у вихідному коді.
  2. Кіт

    1. Сибірський; а. SiberianA - відтворена проблема : літери (тобто "а" тут), не визнані перекладачем як "нумерація".
      • Незалежно від того, він знаходиться з відступом до відокремленої лінії у вихідному коді.
    2. Сіамські
      • а. так написано вручну, як утилізація зловживань куль, ненумерований список.

0

4 пробіли виконують трюк навіть у списку визначення:

Endpoint
: `/listAgencies`

Method
: `GET`

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

Я документую API за допомогою власницького розширення BitBucket Wiki та Markdown для списку визначень найбільш приємно (синтаксис таблиці МД жахливий, вимоги до багатолінійних зображень та вбудовування ...).


-6

Навіть один простір працює

... Просто відкрийте цю відповідь для редагування, щоб побачити її.

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

Вкладені списки, більш глибокі рівні:

  • Елемент першого рівня - немає місця перед символом кулі
    • предмет Aa другого рівня - 1 місця достатньо
      • предмет Aaa третього рівня - 5 місць хв
    • Елемент Ab другого рівня - також можливі 4 місця
  • елемент першого рівня B

    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
    

1
Одного місця недостатньо для другого рівня
JGallardo

"Одного місця недостатньо на другому рівні" .. Про що ти говориш, @JGallardo? Я підготував практичне використання, яке показує, що воно справді працює. Чому я представив вихідний код у своїй відповіді? ..Подивіться самі: відкрийте для редагування. (Але не змінити його, будь ласка.)
Франта

Дивіться аналогічну тему та мою відповідь там: Досить те саме, копіюйте / вставляйте. meta.stackexchange.com/a/325252/361135
Franta

3
Звичайно, в цьому редакторі він працює, але питання стосується BitBucket, і він там не працював. Принаймні, не тоді, коли я востаннє перевіряв у червні 2019 року. Можливо, це було раніше, коли ви писали оригінальну відповідь, але не наскільки мені відомо.
JGallardo
Використовуючи наш веб-сайт, ви визнаєте, що прочитали та зрозуміли наші Політику щодо файлів cookie та Політику конфіденційності.
Licensed under cc by-sa 3.0 with attribution required.