Outline Sections

About

Organize your code with comment-based sections in the VS Code Outline view. In addition to built-in tree-view elements (class, method, etc.), this extension adds support for comment banners and region blocks (#region / #endregion) that also appear as navigable and collapsible sections in the built-in Outline.

[!TIP] This extension is compatible with Comment Divider (strongly recommended)

Preview

Example	Original	With Sections

Supported Languages

Supported Languages	Supported Analyser	Region Comment Style
	typescript-language-features (built-in)	`// #region Name` \| `// #endregion`
	vscode-pylance	`# region Name` \| `# endregion`
	cpptools	`// #region Name` / `// #endregion`
	rust-analyzer	`// #region Name` / `// #endregion`

Development Notes

Install the latest version of Node.js LTS and the dependent packages (note all packages install locally into node_modules/ so no virtual environment is needed):

make setup

Windows: install Node.js LTS from nodejs.org manually, then use make install (requires Git Bash or WSL).

npm run test                          # run tests + generate coverage report
npm run package                       # compile → out/ and build .vsix (what gets published)
npx semantic-release --dry-run        # preview next release version and notes

[!TIP] You can run make clean to clean up compiled/generated files.

Press F5 in VS Code to launch an Extension Development Host with the extension loaded.

How it works?

The extension uses VS Code API to parse the document and create section markers as document symbols based on comments. It then "injects" those symbols into the LSP communicator's parse commands provided by the analyser extension (which depends on language). It's a bit of a simplification but that's the rough idea.

Outline Sections

mantasu

Outline Sections

About

Preview

Supported Languages

Development Notes