Bannerforge
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.
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 (default 60). The width
is automatically widened if the text would not fit.
License
Released under the MIT License. See the LICENSE file for details.
