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

时间:2013-11-13 19:50:21

标签: markdown bitbucket

我在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.,这不是我想要的。也许我应该使用``而不是?结果将不会是相同的样式,但如果我的列表保持编号,它至少会更好。

任何解决方案?

4 个答案:

答案 0 :(得分:10)

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

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

  1. 克隆存储库

    git clone URL

  2. (四个空格和`命令行周围。)

答案 1 :(得分:0)

更好的答案,一般结构应该是这样的:

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

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

3. item n.3

所以:

  1. 在代码块之前和之后添加一个空行。
  2. 用8个空格缩进所有内容;在代码块之前和之后不需要3次反推。
  3. 如果您想要语法高亮显示,请在代码块之前将#!<language-name>缩进8个空格。
  4. Bitbucket会尊重列表编号,你不会失去语法高亮。

答案 2 :(得分:0)

仅总结以上针对在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解析器的输出:

说明

  1. 从BitBucket克隆git仓库

    cd *Install_Directory*
    git clone https://user@bitbucket.org/user/repo.git
    
  2. 安装/升级所需的npm模块

     npm update
    
  3. 运行

    node server.js
    (or)
    nodemon
    
  4. 通过访问http://localhost:9988/

  5. 查看跟踪信息中心

答案 3 :(得分:0)

要扩展@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