如何在Bitbucket中使用Markdown嵌套列表项？

Question

如何在Bitbucket中使用Markdown嵌套列表项？

418

我想在Bitbucket页面中实时查看我的markdown嵌套列表项，并呈现相应的缩进。但即使使用它们的例子（已更新），我仍然无法弄清楚它是如何工作的：

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

对于3a-c中的项目，它忽略了缩进：

我希望它看起来像这样（在SE和Github上语法完全正常）：

他们在列表中的列表示例特别不可接受：

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

这是我专门为此设置的代码库。

- Jeff Puckett

16

你是否使用了四个空格进行缩进？还是少于四个空格？ - Waylan

如果你有一个三重嵌套的列表（列表中包含列表，再包含列表），唯一的方法是使用2个空格进行第一次缩进（第一个嵌套列表），并使用4个空格进行第二次缩进（第二个嵌套列表）。 - tsveti_iko

5个回答

13

即使在定义列表中，缩进4个空格也能达到预期效果：

Endpoint
: `/listAgencies`

Method
: `GET`

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

我正在使用BitBucket Wiki和Markdown专有扩展来记录API，其中定义列表最为令人愉悦（MD的表格语法很糟糕，想象一下多行和嵌入式要求...）。

- gavenkoa

9

可能性

可以将一个符号列表嵌套到更高的编号列表中。
但在符号列表中，自动编号列表将不会开始：它不被支持。
要在符号列表之后开始一个新的编号列表，请在它们之间放置一段文本或副标题：一个新的编号列表不能紧靠在符号列表之后：解释器不会开始编号。

实践中

狗
德国牧羊犬 - 只需单个空格。
比利时牧羊犬 - 最多 4 个空格。

行前的数字被解释为“编号符号”，从而产生缩进。 * ..并忽略书写的数字：在结构符合的情况下，放置/生成它自己的数字。 * 所以只用“1”就可以得到你的编号列表，或者任何整数，甚至是更多位的数字：列表编号将继续递增++1。 * 然而，编号列表中的第一项将被保留，因此第一行通常是数字“1”。
1. 马里努阿 - 5 个空格已经成为第三级。

猫
西伯利亚猫； a. SiberianA - 问题复制：解释器无法将字母（例如此处的“a”）识别为“编号”。

不管它在源代码中被缩进到其分离的行中：这里忽略了缩进。 2. 婆罗门猫
a. 手动编写以使用符号列表的错误解决方法。

- Franta

8

这在Bitbucket Cloud上对我有效。

输入以下内容：

* item a
* item b
** item b1
** item b2
* item3

我来了解一下这件事：

我得到了这个：

- AAA

刚刚在2023年的Bitbucket Cloud中尝试了一下，但是它不再起作用。例如：

* 功能：更新多个组件：
** Harbor图表：13.2.7 -> 16.4.10
** Postgresql-ha图表：8.6.13 -> 10.0.5
** Harbor版本：2.5.1 -> 2.7.1
** Redis版本：6.2.7 -> 7.0.11
** Postgres-exporter：0.10.0 -> 0.12.0

呈现为：

功能：更新多个组件：Harbor图表：13.2.7 -> 16.4.10 Postgresql-ha图表：8.6.13 -> 10.0.5 Harbor版本：2.5.1 -> 2.7.1 Redis版本：6.2.7 -> 7.0.11 ** Postgres-exporter：0.10.0 -> 0.12.0

- jvleminc

-8

即使只有一个空格也可以工作

...只需打开此答案进行编辑即可查看。

嵌套列表，更深层次： ---- 在此处留下一个空行 * 第一级A项目-项目符号前没有空格 * 第二级Aa项目-1个空格就足够了 * 第三级Aaa项目-最少5个空格 * 第二级Ab项目-4个空格也可以 * 第一级B项目

嵌套列表，更深层次：

一级A项目-无需在符号前添加空格
- 二级Aa项目-1个空格就足够了
  - 三级Aaa项目-最少5个空格
- 二级Ab项目-也可以使用4个空格

一级B项目

嵌套列表，更深层次：
...跳过一行并缩进八个空格。（如编辑器帮助中所述，仅适用于此页面）
* 一级A项目-无需在符号前添加空格
 * 二级Aa项目-1个空格就足够了
     * 三级Aaa项目-最少5个空格
    * 二级Ab项目-也可以使用4个空格
* 一级B项目

- Franta

1

第二层不够一个空格。 - JGallardo

"第二层不够一个空格。@JGallardo，你在说什么？我已经准备好了实际用法，证明它确实有效。为什么我在回答中提供源代码呢？请自己看一下：打开它进行编辑。（但请不要更改它。）" - Franta

请参考类似的主题和我的回答：基本相同，复制/粘贴。 https://meta.stackexchange.com/a/325252/361135 - Franta

7

在这个编辑器中确实可以工作，但问题是关于BitBucket，它在那里没有起作用。至少在我上次检查（2019年6月）的时候没有起作用。也许在你写原始答案时它曾经起过作用，但据我目前所知，不是最佳选择。 - JGallardo

网页内容由stack overflow 提供, 点击上面的

可以查看英文原文，
原文链接

- Jeff Puckett · Accepted Answer

733

使用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，您的评论完全正确。

- Jeff Puckett

12

值得一提的是，在某些情况下最好不要对列表进行编号。如果它们只是在呈现的形式下阅读，对每个项目使用“1.”将导致它们自动编号。但是，如果您试图保持文本可读性，则应该避免这种情况。 - Nilpo

4

为什么代码检查工具（linters）开始建议嵌套列表缩进使用两个空格？ - Greg Hilston

1

我无法弄清楚如何在 Atlassian 实验室中推出的新编辑器中完成它。https://confluence.atlassian.com/doc/the-editor-251006017.html 但也许这就是答案？https://confluence.atlassian.com/doc/confluence-wiki-markup-251003035.html#ConfluenceWikiMarkup-Lists - Ryan

1

一些实现使用四个空格来表示代码块，因此无法用于嵌套。 - Pablo Pazos

3

这个问题特别涉及到Bitbucket的实现，可以说有所欠缺。 - Jeff Puckett

显示剩余6条评论