reStructuredText for SQL？

Question

我正在尝试使用DocUtils和reStructuredText来注释SQL代码。当我在多行注释中包含标记时，我可以让它工作。然后，我使用--一些text:：来介绍每个代码块。

我无法使内部超链接起作用。我想写-- ..Step1_：但是解析器会因为前导注释而忽略这一点。使用多行样式也会失败。有没有办法让它起作用呢？

下面是一个例子：

/*
==========
this query
==========
:Author: Me

Outline
==========

- Create table 1

- Create table 2

- Output the result

*/

-- _Step1: build the table::

    create table table1

-- _Step2: use Step1_ to build table 2::

    create table table2

Answer 1

code-block受docutils版本0.10支持，也可以是0.9。