Как разметить вложенные элементы списка в 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
Вы делали отступ на четыре пробела? Или менее?
Вэйлан

Ответы:

279

Используйте 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». для каждого предмета они будут автоматически пронумерованы. Этого следует избегать, если вы пытаетесь сохранить читабельность текста.
Nilpo
1
Любая причина, почему линтеры начинают предлагать 2 места для содержимого вложенного списка?
Грег Хилстон
Я не мог понять, как это сделать в новом Atlassian Editor, который они выпускают в лабораториях. 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 пробелов делает третий уровень еще тоже.
        1. Тервурен - 9 мест для 4-го уровня - умышленно стартовал "55".
        2. TervurenB - пронумеровано как «88» в исходном коде.
  2. Кошка

    1. сибирская; а. SiberianA - воспроизведенная проблема : буквы (то есть «здесь») не распознаются интерпретатором как «нумерация».
      • Неважно, что он имеет отступ в отдельной строке в исходном коде.
    2. сиамский
      • а. так написано вручную, как обходной путь неправильного использования маркеров, ненумерованный список.
Franta
источник
0

4 пробела делают свое дело даже внутри списка определений:

Endpoint
: `/listAgencies`

Method
: `GET`

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

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

gavenkoa
источник
-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

Вложенные списки, более глубокие уровни:

  • первый уровень предмет - нет места перед персонажем пули
    • второй уровень предмета Аа - достаточно 1 места
      • Aaa предмет третьего уровня - мин 5 пробелов
    • Второй уровень Ab item - возможно также 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
    
Franta
источник
1
Одного места недостаточно на втором уровне
JGallardo
"Одного пробела недостаточно на втором уровне" .. О чем ты говоришь, @JGallardo? Я подготовил практическое использование, которое показывает, что это действительно работает. Почему я представил исходный код в своем ответе? ... Просто посмотрите сами: откройте для редактирования. (но не меняйте его, пожалуйста.)
Franta
Смотрите аналогичную тему и мой ответ там: Почти то же самое, скопируйте / вставьте. meta.stackexchange.com/a/325252/361135
Франта
3
Конечно, в этом редакторе он работает, но вопрос о BitBucket, и он там не работает. По крайней мере, когда я последний раз проверял в июне 2019 года. Возможно, раньше, когда вы писали оригинальный ответ, но не в меру моих текущих знаний.
Джаллардо