Question

我在Bitbucket上使用Markdown作为我的README.md，并在代码块之后实现我的有序列表重启为1。以下是我的文字示例：

1. Download VirtualBox
2. Download Vagrant
3. Clone the repository

> git clone URL

4. Go to repository folder

> cd /my_repo

5. Setup your dev environment

我的自述文件中的数字4和5都是1.，这不是我想要的。也许我应该使用``而不是？结果将不会是相同的样式，但如果我的列表保持编号，它至少会更好。

任何解决方案？

Answer 1

在blockquotes >之前插入4个空格。这有两个目的：首先，它缩进引号，因此它与它上面的数字对齐（因为它是该编号项的一部分）。其次，大多数MD解析器都知道这意味着缩进项不应该中断编号列表。

实际上，我认为使用“块引用”是错误的。也许你应该在这里使用常规缩进'代码'，在你的文字代码周围使用4个空格和反引号：

克隆存储库

git clone URL

（四个空格和`命令行周围。）

Answer 2

更好的答案，一般结构应该是这样的：

1. item n.1
2. item n.2

        #!json
        {
            "key": "value"
        }

3. item n.3

所以：

在代码块之前和之后添加一个空行。
用8个空格缩进所有内容;在代码块之前和之后不需要3次反推。
如果您想要语法高亮显示，请在代码块之前将#!<language-name>缩进8个空格。

Bitbucket会尊重列表编号，你不会失去语法高亮。

Answer 3

仅总结以上针对在BitBucket上遇到此问题的用户的评论，以下是一段代码，我将README.md样板用于可工作的nodejs / express项目：

**Instructions**

1. Clone the git repo from BitBucket

    ```
    cd *Install_Directory*
    git clone https://user@bitbucket.org/user/repo.git
     ```

2. Install/upgrade required npm modules

    ```
     npm update
     ```

3. Run

    ```
    node server.js
    (or)
    nodemon
    ```

4. View tracking dashboard by visiting http://localhost:9988/

为完整起见，以下是使用StackOverflow的markdown解析器的输出：

说明

从BitBucket克隆git仓库

cd *Install_Directory*
git clone https://user@bitbucket.org/user/repo.git

安装/升级所需的npm模块
```
 npm update
```
运行
```
node server.js
(or)
nodemon
```
通过访问http://localhost:9988/

Answer 4

要扩展@Willian's解决方案，请尝试将代码缩进8个空格，这似乎启用了 basic 块高亮显示，而不是代码语法。另外，如果您在代码之前嵌套了一些项目符号，则将无法使用。就像您在代码之前＃3下嵌套了几个子弹一样。

1. First item
2. Second Item
3. Some code example:  

        var a = "Some string";
        function test() {
            return a + "/n";
        }

4. Forth item

Bitbucket自述文件降序排序列表在代码块后重新启动

4 个答案: