reStructured Ecosystem¶
By Lex Li
reStructuredText has evolved for decades and ever since Visual Studio Code was born, an ecosystem is built around it to serve a variety of users. This article provides a snapshot of the main components currently being used by more than 370,000 active users.
reStructuredText Extension for Visual Studio Code¶
This is currently the core of the ecosystem with most users. Its frequent releases keep bringing new features and bug fixes, and also integrate with the best and latest components of the whole ecosystem.
Note
Later this extension might be referred to as vscode-restructuredtext.
reStructuredText Syntax Highlighting¶
This is an extension created by Trond Snekvik, which focuses on syntax highlighting and section navigation.
Note
Later this extension might be referred to as vscode-rst.
Important
vscode-restructuredtext prompts new users to install vscode-rst, to ensure that all users receive the best in class syntax highlighting.
Esbonio Language Server¶
This is a language server created by Alex Carney that provides the essential asset to enable reStructuredText language services,
Linting
Build error detection
Live preview
It ships as a Python module.
Important
vscode-restructuredtext prompts new users to install esbonio so that language services can be enabled.
Warning
If more code linting than esbonio is required, users can install individual linters such as doc8, rstcheck, and restructuredtext_lint.
Microsoft Python Extension¶
This extension is not that closely related to reStructuredText itself, but does provide good support on selecting Python interpreters and so on.
Important
vscode-restructuredtext prompts new users to install vscode-python.