在列表项中结束文字块

End literal block in list item

我的第一个文件中有一个列表项,我想将文字块放入其中,但我无法使文字块正确结束。

这是我的第一个:

1. Item 1 (not literal)
2. Item 2::

    MyCode.example()

    Description of the code shown above (not literal)

我希望以 Description 开头的段落位于其上方的文字块之外,但仍然是列表项 #2 的一部分。我能够想出的唯一解决方法是:

1. Item 1 (not literal)
2. Item 2:

    ::

        MyCode.example()

    Description of the code shown above (not literal)

这允许非文字文本 return 到上一级缩进,使一切看起来都像我想要的那样。但是,我希望列表项的第一行有 ::

是否有可能以允许 :: 保留在列表项的第一行的方式显式结束文字块?

是的。白space 很棘手。您的代码中有一个额外的前导 space 和以“Description”开头的行。试试这个:

1.  Item 1 (not literal)
2.  Item 2::

        MyCode.example()

    Description of the code shown above (not literal)

请注意,项目和描述的首字母垂直对齐,代码块缩进 4 space秒。

额外提示:我喜欢在带编号的项目及其句点之间添加一个 space,以便它从第 5 列开始。这样可以更轻松地将段落缩进到 4 space 秒(并且代码块 8 spaces) 在我的编辑器中。如果我有超过 9 个项目,那么第 10-99 个项目的缩进看起来更好。