2017-11-10 15 views
0

我有以下的降價片斷,這將是在Github上可見:不正確的嵌套列表格式

1. Ask a supervisor for a `cmprod.pem` file and move it into the `~/.ssh` folder. 
2. Run `chmod 600 ~/.ssh/cmprod.pem` 
3. Run `eb ssh` and type `yes` when it asks if you would like to add the key to your keychain. 
4. Once connected via SSH, to access the application's source code, perform the following steps 
   - `sudo docker ps` 
   - Copy the desired value from the `CONTAINER ID` column 
    - Run `sudo docker exec -it $CONTAINER_ID rails c` using the copied value. 

的問題是,嵌套列表(第4步下三個要點)是不正確的格式。他們最終看起來像這樣:

  1. 向主管的cmprod.pem文件,並將其移動到文件夾~/.ssh
  2. 運行chmod 600 ~/.ssh/cmprod.pem
  3. 運行eb sshyes類型時,它問你是否想將鍵添加到您的鑰匙串。
  4. 通過SSH一旦連接,來訪問應用程序的源代碼,執行以下步驟 - sudo docker ps - 使用複製的值從CONTAINER ID
    • 運行sudo docker exec -it $CONTAINER_ID rails c所需的值複製。

回答

1

這取決於您正在使用哪個規則集。根據GitHub使用的Commonmark(我假設這是因爲[github]標籤而相關的),「列表可以中斷一個段落,也就是說,不需要空行來將段落與下面的列表分開。 「規範的Example 280甚至顯示了一個類似於你的例子。如果它不適合你使用Commonmark解析器,那麼這將是一個錯誤。

但是,如果您不使用Commonmark(或作爲任何Commonmark錯誤的解決方法),那麼Markdown規則要求您在列表和上一段落之間有一個空行。由於父母名單第4項中的文本將是一個段落(在列表項目內),因此該段落和該段落後面的子列表項目之間需要有一個空行。像這樣:

1. Ask a supervisor for a `cmprod.pem` file and move it into the `~/.ssh` folder. 
2. Run `chmod 600 ~/.ssh/cmprod.pem` 
3. Run `eb ssh` and type `yes` when it asks if you would like to add the key to your keychain. 
4. Once connected via SSH, to access the application's source code, perform the following steps 

    - `sudo docker ps` 
    - Copy the desired value from the `CONTAINER ID` column 
    - Run `sudo docker exec -it $CONTAINER_ID rails c` using the copied value. 

記住當嵌套列表項時,你需要遵循所有在列表之外的規則。然後縮進一個級別。因此,舉例來說,一切都嵌套在第4項是這樣的外部列表項:

Once connected via SSH, to access the application's source code, perform the following steps 

- `sudo docker ps` 
- Copy the desired value from the `CONTAINER ID` column 
- Run `sudo docker exec -it $CONTAINER_ID rails c` using the copied value. 

您需要的段落和列表之間的空行。因此,將所有內容嵌套到列表中時,您需要保持相同的格式並保留空白行。僅僅因爲第一行從子彈(或列表號)開始並不意味着它不遵循相同的規則。

最後,即使您使用的是Commonmark解析器,我也會建議使用空白行。這是任何Markdown棉絨都會提出的一種很好的形式。

+0

我試着粘貼你的第一個片段,它的工作原理與上述相同。但我不明白爲什麼它不適用於我的MD文件。你可以看看這個,讓我知道如何編輯它,所以最後列表格式正確? https://gist.github.com/maxp-edcast/9d7bbf0e28a4666dc2b492403cbc5d3b –

+0

刪除您的子列表中項目2前面的縮進並鍵入四個新空格。四個空格中的兩個實際上並不是空格,而是非空格(Unicode字符「xa0」),這使Markdown變得混亂。事實上,每當嵌套列表不起作用時,我總是首先檢查縮進。我在回答(通過計數)之前檢查了你的,但沒有注意到不間斷的空格字符。當我發佈我的答案時,我刪除了縮進並重新創建了它,所以我沒有遇到你的問題。 – Waylan

+0

順便說一句,我發現你的問題,在適當的文本編輯器中打開你的文件,然後打開所有隱藏的字符。它立即顯示了兩個非破壞空間與文檔中的所有其他空間不同。 – Waylan