About this project

Code Organizer is a VS Code extension for navigating large source files. It reads lightweight comment markers ending with four or more dashes, such as # Section ----, and turns them into outline entries. Users can open VS Code's Outline panel and click a section to jump to it. The extension also integrates with breadcrumbs and Go to Symbol. Sections support hierarchical nesting. For Python, R, and Shell, ##, ###, and #### create deeper levels; other comment styles use repeated markers such as //// and //////. The README provides examples for Python, JavaScript, TypeScript, C++, Java, Go, Rust, React JSX/TSX using {/* // Section ---- */}, SQL/PostgreSQL using -- Section ----, and Mermaid using %% # Section ----. Release notes also mention Markdown and Quarto header detection, with handling for fenced code blocks and YAML front matter. Configuration is minimal. Settings include codeOrganizer.enable, codeOrganizer.supportedLanguages (default wildcard for every language), codeOrganizer.minDashes (default 4, minimum 2), codeOrganizer.maxNestingLevel (default 4, range 1 to 6), and codeOrganizer.showIcons (default true). The extension can be installed from the VS Code Marketplace or with the command code --install-extension ran-codes.code-organizer-vscode. It is MIT licensed.