python - 如何为开发者博​​客做一个更好的 Markdown

Question

我正在重建我的博客 http://www.elmalabarista.com/blog/ .我在以前的版本 markdown 中使用过，现在我记得为什么我的代码示例几乎为零。在 markdown 中做代码示例是非常脆弱的。

我试着把一些 python 放在那里我不能让 markdown 将它标记为代码!。罪魁祸首？语法是 markdown，因为代码没有空格。尽管我使用 wmd 作为编辑器(在 SO 中如何工作对我来说是一个谜)，但它永远无法移动文本，因此永远无法获得代码。这是问题所在:

我放一些简单的东西:

:::python
def hello():
   pass

但问题是我有:

::: python 定义你好(): 通过

或

::: python 定义你好(): 通过

(是的，机器人已格式化，但您看到了吗？不起作用)。任何错误——使用制表符、太多、太少的空格)都会受到严厉的惩罚。如果代码很长，出现问题的可能性也会增加。

所以，存在任何简单的方法:

### 我的文章

1. 我的列表条目一
2. 我的列表条目二

::: python 定义 x (a, b): 返回 a * b

然后变得正确，再也不用为这种小事烦恼了？？？

顺便说一下，我正在使用 pygments 和 python markdown。

Answer 1

考虑使用 reStructuredText -- 它是 Python 的标准轻量级标记，通常用于文档字符串和嵌入式文档。它非常简单，但也很强大——如果我没记错的话，核心 Python 库和 Django 都使用它。