Посмотрев на это еще немного, я наткнулся на документ reStructuredText Interpreted Text Roles . Из этого документа:
В интерпретируемом тексте вокруг текста используются обратные кавычки (`). Явный маркер роли может по желанию появляться до или после текста, разделенного двоеточиями. Например:
This is `interpreted text` using the default role.
This is :title:`interpreted text` using an explicit role.
Кажется, что code
роль есть , поэтому можно просто набрать
:code:`a = b + c`
для рендеринга встроенного блока кода. Чтобы получить подсветку синтаксиса, вы можете определить пользовательскую роль. Например
.. role:: bash(code)
:language: bash
который затем можно использовать так:
Here is some awesome bash code :bash:`a = b + c`.
Обратите внимание, что определение роли должно быть размещено перед ссылками на роль.
Обратите внимание: в документе, на который я ссылаюсь, не упоминается версия документа, на которую он ссылается. Роль код не доступен в Docutils 0.8.1 (который является единственной версией , я должен испытания против).