reStructuredText 支持
除了支持 reStructuredText Docstring 格式 (PEP 287) 外，PyCharm 还提供了一个用于编辑 restructured text 的编辑器。
与 Markdown 编辑器 类似，您可以修改 reStructuredText 文件并在预览面板中验证结果。
您可以打开任何包含 reStructuredText 的现有文件，或从头创建一个新文件。
创建一个 .rst 文件
在 项目 工具窗口中右键点击，然后选择 。 在打开的对话框中，指定带有 .rst 扩展名的任意文件名，然后点击 确定。
PyCharm 会识别该文件类型，并使用相应的图标进行标记。
新建的文件会在编辑器中打开。
让我们添加一些内容，看看 PyCharm 如何帮助编辑restructured text。
编辑文本
在 设置 对话框（Ctrl+Alt+S ）中，查看 reStructuredText（ ）的默认配色方案。 如有需要，请为标记元素设置其他颜色和效果。
点击 确定 以保存更改并关闭窗口。
添加任意章节结构标记并预览结果。
使用 .. code-block:: 指令添加代码片段。 PyCharm 支持指令名称的代码补全。
您可以通过在指令中指定特定语言来启用代码语法高亮显示： .. code-block:: python 。 另外，请确保您的项目解释器中， Pygments 软件包 已安装。
您可以在文本中快速标记链接，并推迟添加引用目标。 PyCharm 会通知您，并高亮显示缺少引用的链接。
您只需在 reStructuredText 文件中添加适当的目标引用，例如： .. _pytest: https://docs.pytest.org/ 。
2026年 7月 14日