如何在Bitbucket中标记嵌套列表项?


172

我正在尝试从Bitbucket页面实时浏览器中查看带有相应缩进的markdown嵌套列表项。但是即使使用他们的示例更新),我也无法弄清楚它是如何工作的:

* 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
您缩进了四个空格吗?或更少?
Waylan,2016年

Answers:


275

使用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
短绒棉开始建议嵌套列表内容使用2个空格的任何原因?
格雷格·希尔斯顿

我无法弄清楚他们正在实验室中推出的新Atlassian编辑器中如何做到这一点。confluence.atlassian.com/doc/the-editor-251006017.html但这也许是答案?confluence.atlassian.com/doc/…–
瑞安(Ryan)

一些实现将四个空格用于代码块,因此不能用于嵌套
Pablo Pazos

2
@PabloPazos这个问题专门关于Bitbucket的实现,可以说是有问题的。
杰夫·普基特

4

可能性

  • 可以将没有项目符号编号的列表嵌套到编号更高的列表中。
  • 但是在项目符号编号列表中,自动编号列表将不会启动:不支持。
    • 要在没有项目符号编号的列表之后开始一个新的编号列表,请在它们之间加上一段文字或添加一个字幕:新的编号列表不能仅在项目符号后面开始:解释器将不会开始编号。

在实践中

    1. 德国牧羊犬-前面只有一个空格。
    2. 比利时牧羊犬-前方最多4个空格。
      • 一行前面的数字被解释为“编号项目符号”,因此要缩进。
        • ..并忽略书面数字:按照结构放置/生成自己的数字。
        • 因此,仅使用“ 1”即可获得编号列表。
          • 或任何整数,甚至更多数字:列表编号将以++ 1的增量继续。
        • 但是,编号列表中的第一个项目将保留,因此第一个前导通常是数字“ 1”。
    3. Malinois-5个空格已经达到了第3级。
      1. MalinoisB-5个空格已经达到了第3级。
      2. Groenendael-8个空格也达到了第3级。
        1. 特尔菲伦-第4层有9个空格-故意由“ 55”开头。
        2. TervurenB-在源代码中以“ 88”编号。
    1. 西伯利亚 一个。西伯利亚A- 复制的问题:口译员无法识别为“编号”的字母(即“ a”)。
      • 没关系,它在源代码中缩进到其分隔的行中。
    2. 连体
      • 一个。因此,请手动写成解决方法,误用项目符号和未编号的列表。

0

即使在定义列表中,也有4个空格可以解决问题:

Endpoint
: `/listAgencies`

Method
: `GET`

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

我使用BitBucket Wiki和Markdown专有扩展名定义列表的API记录是最令人愉悦的(MD的表语法很糟糕,需要多行显示和嵌入...)。


-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

嵌套列表,更深层次:

  • 一级A项目-项目符号字符前面没有空格
    • 第二级Aa项目-1个空间就足够了
      • 第三级Aaa项目-最少5个空格
    • 第二级Ab项目-也可以有4个空格
  • 乙级第一项

    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?我已经准备了实际用法,表明它确实有效。我在回答中提供了源代码吗?..您自己看看:打开进行编辑。(但请不要更改。)
Franta

看到类似的主题和我的回答:完全相同,复制/粘贴。meta.stackexchange.com/a/325252/361135
福兰特

3
当然可以在此编辑器中运行,但问题是关于BitBucket的,并且在那里不起作用。至少在我上次于2019年6月检查时不是这样。也许它曾经是您编写原始答案的时间,但据我所知,这还不是。
JGallardo
By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.