Ответ 1
Я не уверен на 100%, это то, что вы ищете, но может помочь директива .. contents::
. По умолчанию он предоставит вам заголовки для всей страницы, где бы вы ни указали директиву. С указанным :local:
он будет генерировать локальный TOC для заголовков ниже, где вы укажете директиву (удобна для подстроек).
Подробнее здесь: http://docutils.sourceforge.net/docs/ref/rst/directives.html#table-of-contents