Forge clean ASCII comment banners, boxed headers, and divider lines right in your editor — language-aware, zero configuration required.
Mark up your source with readable section headers instead of hand-aligning dashes and slashes. Bannerforge picks the correct comment marker for your file and lays out the text for you.
Features
- Bannerforge: Insert Block Banner — wraps your text between two full-width
=dividers, the text centred on the middle line. - Bannerforge: Insert Boxed Banner — draws an ASCII box (
+,-,|) around the centred text. - Bannerforge: Insert Divider Line — a single full-width
=rule, no text needed.
Every line is prefixed with the comment marker for the active language, so the banner is valid right where you drop it.
Example
In a TypeScript file, a boxed banner for the text Configuration looks like:
// +-----------------------------------------------------+
// | Configuration |
// +-----------------------------------------------------+
A block banner:
// ============================================================
// Configuration
// ============================================================
A divider line:
// ============================================================
Usage
- Select the text you want in the banner (or run a command and type it when prompted). The divider line needs no text.
- Open the Command Palette and run Bannerforge: Insert Block Banner, Insert Boxed Banner, or Insert Divider Line.
- The banner replaces your selection, or is inserted at the cursor.
Language-aware comment markers
Bannerforge chooses the comment marker from the file's language using a small
heuristic: // for JavaScript/TypeScript/C/C++/Java/Go/Rust/PHP, # for
Python/Ruby/shell/YAML, and -- for Lua/SQL. Unknown languages fall back to
//.
Settings
bannerforge.width— total banner width in columns (default60). The width is automatically widened if the text would not fit.
License
Released under the MIT License. See the LICENSE file for details.