Comment démarquer des éléments de liste imbriqués dans Bitbucket?

173

J'essaie de voir mes éléments de liste imbriqués markdown rendus avec l'indentation correspondante lorsqu'ils sont affichés dans un navigateur en direct à partir des pages Bitbucket. Mais je ne peux pas comprendre comment cela fonctionne même en utilisant leurs exemples ( mis à jour ):

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

Il ignore l'indentation pour les éléments 3a-c:

liste de rendu bitbucket

Je veux que cela ressemble à ceci (la syntaxe fonctionne parfaitement bien sur SE et Github):

Liste de rendu SE

Leur liste en exemple de liste est particulièrement inacceptable:

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

liste dans la liste sur bb

Voici un repo que j'ai mis en place juste pour cela.

Jeff Puckett
la source
6
Avez-vous mis en retrait de quatre espaces? Ou moins?
Waylan

Réponses:

279

Utilisez 4 espaces.

# 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

Voici une capture d'écran de ce dépôt mis à jour:

capture d'écran

Merci @Waylan , votre commentaire était tout à fait exact.

Jeff Puckett
la source
4
Il convient également de mentionner qu'il est conseillé de ne pas numéroter vos listes dans certains cas. S'ils sont uniquement destinés à être lus sous forme rendue, utilisez "1". pour chaque élément, ils seront numérotés automatiquement. Cela devrait être évité si vous essayez de maintenir la lisibilité du texte.
Nilpo
1
Une raison pour laquelle les linters commencent à suggérer 2 espaces pour le contenu de la liste imbriquée?
Greg Hilston
Je ne pouvais pas comprendre comment le faire dans le nouvel éditeur Atlassian qu'ils déploient dans Labs. confluence.atlassian.com/doc/the-editor-251006017.html Mais c'est peut-être la réponse? confluence.atlassian.com/doc/…
Ryan
certaines implémentations utilisent quatre espaces pour les blocs de code, donc cela ne peut pas être utilisé pour l'imbrication
Pablo Pazos
2
@PabloPazos, cette question concerne spécifiquement l'implémentation de Bitbucket, qui est sans doute insuffisante.
Jeff Puckett
4

Possibilités

  • Il est possible d'imbriquer une liste à puces non numérotée dans une liste numérotée plus élevée.
  • Mais dans la liste à puces sans numéro, la liste numérotée automatiquement ne démarre pas: elle n'est pas prise en charge.
    • Pour commencer une nouvelle liste numérotée après une liste à puces non numérotée, placez un morceau de texte entre elles, ou un sous-titre: Une nouvelle liste numérotée ne peut pas commencer juste derrière la puce: L'interprète ne commencera pas la numérotation.

en pratique

  1. Chien

    1. Berger allemand - avec un seul espace devant.
    2. Berger belge - max 4 places devant.
      • Numéro devant une ligne interprété comme une "puce de numérotation", faisant ainsi l'indentation.
        • ..et ignore le chiffre écrit: Place / génère le sien, conformément à la structure.
        • Il est donc normal de n'utiliser que des "1" pour obtenir votre liste numérotée.
          • Ou quel que soit le nombre entier, même de plus de chiffres: la numérotation de la liste se poursuivra par incrément ++ 1.
        • Cependant, le premier élément de la liste numérotée sera conservé, de sorte que le premier interligne sera généralement le nombre «1».
    3. Malinois - 5 cases font déjà le 3e niveau.
      1. MalinoisB - 5 espaces font déjà le 3ème niveau.
      2. Groenendael - 8 espaces fait encore le 3e niveau.
        1. Tervuren - 9 places pour le 4ème niveau - Commencé intentionnellement par "55".
        2. TervurenB - numéroté par "88", dans le code source.
  2. Chat

    1. Sibérien; une. SibérieA - problème reproduit : lettres (c'est-à-dire "a" ici) non reconnues par l'interprète comme "numérotation".
      • Peu importe, il est indenté sur sa ligne séparée, dans le code source.
    2. Siamois
      • une. ainsi écrit manuellement comme une solution de contournement abusant des puces, liste non numérotée.
Franta
la source
0

4 espaces font l'affaire même dans la liste de définitions:

Endpoint
: `/listAgencies`

Method
: `GET`

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

Je documente l'API en utilisant BitBucket Wiki et l'extension propriétaire Markdown pour la liste de définitions est très agréable (la syntaxe de la table de MD est horrible, l'imagerie multiligne et les exigences d'intégration ...).

gavenkoa
la source
-6

Même un seul espace fonctionne

... Ouvrez simplement cette réponse pour la modifier pour la voir.

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

Listes imbriquées, niveaux plus profonds:

  • élément de premier niveau A - pas d'espace devant le caractère de puce
    • Objet Aa de deuxième niveau - 1 espace suffit
      • Objet Aaa de troisième niveau - 5 espaces min
    • Élément Ab de deuxième niveau - 4 espaces également possibles
  • élément de premier niveau 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
la source
1
Une place ne suffit pas au deuxième niveau
JGallardo
"Un espace ne suffit pas au deuxième niveau" .. De quoi tu parles, @JGallardo? J'ai préparé l'utilisation pratique, qui montre que cela fonctionne vraiment. Pourquoi ai-je présenté le code source dans ma réponse? ..Voyez-le vous-même: ouvrez-le pour modification (mais ne le changez pas, s'il vous plaît.)
Franta
Voir le sujet similaire et ma réponse là-bas: Assez la même chose, copier / coller. meta.stackexchange.com/a/325252/361135
Franta
3
Bien sûr, dans cet éditeur, cela fonctionne, mais la question concerne BitBucket et cela n'a pas fonctionné là-bas. Du moins pas lors de ma dernière vérification en juin 2019. Peut-être que c'était le cas lorsque vous écriviez la réponse originale, mais pas à ma connaissance actuelle.
JGallardo