ctrl+shift+p filters: :st2 :st3 :win :osx :linux


by oleg-shilo ST3

CodeMap - is a ST3 plugin for showing the code tree representing the code structure of the active view/document


  • 1.0.13
  • github.​com
  • github.​com
  • 2 weeks ago
  • 24 minutes ago
  • 11 months ago


  • Total 826
  • Win 462
  • OS X 205
  • Linux 159
Jan 23 Jan 22 Jan 21 Jan 20 Jan 19 Jan 18 Jan 17 Jan 16 Jan 15 Jan 14 Jan 13 Jan 12 Jan 11 Jan 10 Jan 9 Jan 8 Jan 7 Jan 6 Jan 5 Jan 4 Jan 3 Jan 2 Jan 1 Dec 31 Dec 30 Dec 29 Dec 28 Dec 27 Dec 26 Dec 25 Dec 24 Dec 23 Dec 22 Dec 21 Dec 20 Dec 19 Dec 18 Dec 17 Dec 16 Dec 15 Dec 14 Dec 13 Dec 12 Dec 11 Dec 10 Dec 9
Windows 0 1 1 1 3 1 0 2 1 3 0 1 2 1 1 1 1 0 3 4 0 1 1 0 1 0 1 4 2 1 1 1 2 1 1 4 0 0 0 1 4 2 3 4 1 1
OS X 0 0 2 1 0 2 0 0 1 1 1 3 0 0 0 0 0 0 1 0 2 2 1 0 0 0 2 3 0 1 0 0 1 0 1 1 1 1 0 2 0 0 1 0 0 1
Linux 0 2 0 0 0 0 0 0 2 1 0 4 0 0 1 0 0 0 2 1 2 0 1 0 0 1 1 2 0 0 1 0 2 2 0 2 0 0 0 0 4 0 1 1 0 0



Sublime CodeMap

A plugin for displaying the code map (code structure tree) in the Sublime Text 3 editor.

This plugin is a port of PyMap Visual Studio extension.

Plugin currently supports building the code tree for Python. Support for C# is in the pipeline. The design of plugin allows integration of the user defined tree building algorithm for other languages. The custom syntax integration infrastructure and and samples will be available in the next release.


Note the plugin was developed and tested against ST3 but not ST2.

Package Control

You can install the pluging Package Control.


  • Remove the package, if installed, using Package Control.
  • Add a repository: https://github.com/oleg-shilo/sublime-codemap.git
  • Install sublime-codemap with Package Control.
  • Restart Sublime editor if required

You can also install the plugin by cloning sublime-codemap repository into your Packages folder or manually placing the download package there.


The plugin uses a dedicated view group Code - Map (on right side) to mimic a “side bar” with the content (code tree) that represents code structure of the active view content in the primary view group.

The code tree automatically refreshes on saving the active document or switching the tabs. The usage is quite simple. You can double-click a node in the code tree and this will trigger navigation to the corresponding area in the code (in active document). Alternatively you can synchronize code tree node selection with the current caret position in the document by triggering sync_code_map command either from Command Palette or by the configured shortcut.

To start working with CodeMap just make the map view visible (e.g. [alt+m, alt+m]) and set the focus to the code view.

Command Palette

Press cmd+shift+p. Type codemap to see the available commands:

  • Toggle Visibility - Show/Hide CodeMap view. The CodeMap view is always placed in the most right column (group) of the active window. If show_in_new_group is set to true, a new group will be created.
    Default keybinding is Alt+m Alt+m

  • Reveal in CodeMap - Select code tree node that corresponds the caret position in the code (active view).
    Default keybinding is Alt+m Alt+.

  • Render From View - Attempt to render CodeMap from a view that isn't bound to a phisycal file.
    Default keybinding is Alt+m Alt+,

Custom mapping

Custom mapper

You can extend the built-in functionality with custom mappers. A Custom Mapper is a Python script, which defines a mandatory def generate(file) routine that analyses a given file content and produces a 'code map' representing the content structure.

You can find the md.py sample in the source code. This mapper builds the list of markdown sections in the given text file. In order to activate the mapper its script needs to be properly named and placed in the special folder: <Packages>\User\CodeMap\custom_mappers. The name of the mapper file must follow a special naming convention: "<extension>.py"

Example: "%APPDATA%\Sublime Text 3\Packages\User\CodeMap\custom_mappers\md.py"

You can associate a syntax with the custom mapper, so that the CodeMap will use it for rendering the map content. Custom syntaxes can also be put in Packages\User\CodeMap\custom_languages. The syntax association must be specified in the custom mapper itself:

map_syntax = 'Packages/Python/Python.tmLanguage'

Python syntax seems to be a good highlighting schema for majority of mapping scenarios.

Universal Mapper

The universal mapper is a generic Regex based mapper that can be used as an alternative for dedicated custom mappers. The mapping algorithm(s) of the universal mapper is defined in the plugin settings, and is extension-dependent.

The plugin will always try to use universal mapper mapping algorithm first, and only if it's not available the plugin will try to locate a dedicated custom mapper based on the active document file extension. Full instructions on how to make a custom mapper using the universal mapper are included in the settings file.

Note that if you use a custom mapper for an extension that is already defined in the universal mapper settings, the latter will have precedence. Comment out the extension in the universal mapper section to use your custom mapper in its place.

The advantage of using the universal mapper (and define new rules for it when needed) is that it supports by default the map depth system, with which you can alter the depth of the displayed map. Custom mappers need to support this system internally.

Below is a simple example of adding universal mapper support for TypeScript:

Add file extension (e.g. 'ts') and name of the algorithm section to the syntaxes section:

"syntaxes":     [
                        ["universal",   ""],
                        ["text",        "txt"],
                        ["typescript",  "ts"],
                        ["python",      "py"]

Create a new typescript section an fill it with the the following content:

"typescript": {
                        "^(class |function |export class |interface ).*$",
                "indent": 4,
                "obligatory indent": false,
                "empty line in map before": "class",
                "line numbers before": false,
                "prefix": "",
                "suffix": "()",
                "syntax": "Packages/TypeScript/TypeScript.tmLanguage"

Map depth

If using the universal mapper or a dedicated mapper that supports it, you can change the depth of the displayed map. Default hotkeys are:

{ "keys": ["alt+m", "alt+left"], "command": "code_map_decrease_depth" },
{ "keys": ["alt+m", "alt+right"],"command": "code_map_increase_depth" },

Navigation with Keyboard

You can start keyboard navigation with Al+m, Alt+n. Then use the following keys:

up / down                   move by definition
alt+up / alt+down           move by class
enter/escape/left/right     focus back on edited view


You can also configure plugin to: 1. Hide the group on closing the CodeMap view when it is the only view in the group. 2. Always place CodeMap view in the individual most-right column. 3. CodeMap group width. 4. Assign a custom font size/font face/margin for the CodeMap.


    "close_empty_group_on_closing_map": true,
    "show_in_new_group": true
    "codemap_width": 0.17,
    "codemap_font_size": 8,
    "codemap_font_face": "Verily Serif Mono",
    "codemap_margin": 8,