Markdown/Github：代码块的语法高亮显示为列表的子项答案

【问题标题】：Markdown/Github: syntax highlighting of code block as a child of a listMarkdown/Github：代码块的语法高亮显示为列表的子项
【发布时间】：2011-09-08 07:46:22
【问题描述】：

在 Github/MD 中，如果我们想在它是 list 的子节点时启用代码块，我们需要将其意图 8 个空格。

但是如何使该代码块具有语法高亮功能？

以下代码无法按预期工作...

    1. foo

             ```python
                print 'bar'
             ```

    2. bar

【问题讨论】：

标签： github markdown

【解决方案1】：

```python
print 'bar'
```

没有空格应该可以：来自GitHub help page:

只需将代码块包装在 ``` 中，您无需手动缩进即可触发代码块。

如下hilz的answer所示，你需要缩进````，缩进级别比你的列表要多2个空格。
代码块的内容没有'不需要缩进。

1. foo

  ````python
print 'bar'
  ````

  1.

    ````python
print 'bar'
    ````

见this gist as an example:

【讨论】：

我的意思是它们在列表中，请参阅我更新的代码。谢谢。
@Howard：列表和预先格式化的代码不能很好地混合在一起。我更喜欢手动制作列表，以确保正确呈现预格式化的代码。
@VonC：我的“手动制作列表”是什么意思？使用 Markdown 斜线点转义语法？
我试过了，但是我的语法高亮代码块缩进不遵循它所在的列表。@Howard 你真的成功地使用 `` 缩进了列表中间的语法高亮代码块?
不幸的是，这在跟踪器中似乎不再起作用 - 缩进 8 个空格有效，但显然不太方便

【解决方案2】：

要在列表中愉快地嵌入带有语法高亮显示的代码块，请将代码块前后的标记行嵌入到适当的缩进级别以增加段落，然后照常进行。例如：

1. lorem ipsum

  ```ruby
resources :dolor
  ```

   1. sit amet

      ```ruby
resources :elit
      ```

   1. sed do

1. eiusmod

将每个代码块缩进到适当的深度并保持索引的完整性。

【讨论】：

这行得通。我只需要将整个块缩进 2 个空格，以使代码块成为列表项的一部分。我认为这比公认的答案更好地回答了这个问题。
这应该是公认的答案，因为它实际上解决了 OP 中的问题，即 in a list 语法高亮代码块的问题。
这不再起作用了。

【解决方案3】：

如今，您必须执行以下操作：

1. lorem ipsum
  ```perl
  use strict;
  ```
2. dolor sit amet
      ```perl
      use warnings;
      ```
   1. consectetur adipiscing elit
   1. sed do
1. eiusmod

也就是说，请确保您的语法高亮代码与反引号在同一列中开始。您还必须稍微帮助编号，因为在代码块之后它似乎失去了计数。

另请参阅：https://gist.github.com/therealbstern/9cb0dfc7f0f4b76a062247676aed341b

【讨论】：

Shiki 在上面的评论中指出了这一点，在 hilz 的回答下，但我需要将其放入答案中，因为将正确答案隐藏在评论中似乎不够清楚。此外，cmets 不允许完整的降价，这需要使其非常清晰。