小编Chr*_*ris的帖子

我正在尝试使用DocUtils和reStructuredText注释SQL代码。当我在多行注释中包含标记时，可以使它起作用。然后，我使用--Some 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