myHeaders Sublime Plugin

myHeaders creates and navigates standardized, hierarchical comment headers in Sublime Text 4. It gives large files a navigable outline without requiring language-specific symbol indexes.

The problem

Long files — configuration, generated output, prose drafts — often have no symbol table that a goto-anything index can surface. Ad-hoc comment banners work for the author but not for tooling: they lack a consistent grammar, so navigation, folding, and search can't rely on them. The alternative is maintaining a separate outline document that drifts from the source.

The approach

myHeaders defines a fixed header grammar (level markers and delimiter conventions) and provides commands to insert, navigate, and fold by level. The grammar is language-agnostic and works in any syntax that supports comments, so it applies across Python, TypeScript, Markdown, and plain text without per-language configuration. Twenty tests cover insertion, nesting, and navigation.

What it demonstrates

Published at 0.7.0 with 20 tests, CI, pre-commit hooks, typed source, and 3 documentation pages. The test count is the highest in the Sublime plugin fleet after myTest itself, reflecting that a grammar-based feature lives or dies on its edge cases — level boundaries, delimiter conflicts, nesting depth.