Grim Wrapper 🪦

Minimalist comment, Markdown, and plain text wrapping.

Install from Visual Studio Marketplace or Open VSX Registry

Features

• Very minimal and fast.
• Works in most popular programming languages, Markdown, and plain text.
• Supports Markdown lists and JavaDoc/JSDoc/XMLDoc tags.
• Limited scope to a single paragraph (part of a comment separated by empty lines).
• Almost zero config: the only option is maximum line length.
• Doesn’t pollute the editor with too many commands and hotkeys.

Commands

You can either run this commands from the Command Palette (Cmd+Shift+P on a Mac, or Ctrl+Shift+P on Windows).

Settings and keybinding

You can change the following options in the Visual Studio Code setting:

You can define maxLength for each language separately:

{
  "[python]": {
    "grimWrapper.maxLength": 72
  },
  "[javascript]": {
    "grimWrapper.maxLength": 90
  }
}

This extension doesn’t define any hotkeys, but you can define the keybinding for the command above.

Changelog

The changelog can be found on the Changelog.md file.

How is it different from other extensions?

I’ve been using Rewrap for a long time, but it doesn’t always do what I want:

• No support for JSX comments.
• Often weird formatting of multiline comments (/* ... */, etc.).
• I don’t like the way it format Markdown todos and JSDoc tags.

Check out samples to get an idea how it formats comments.

You may also like

Check out my other Visual Studio Code extensions:

• Just Blame: Git Blame annotations, inspired by JetBrains editors
• Emoji Console Log: insert console.log() statements with a random emoji
• Mini Markdown: minimalist kit for comfortable Markdown writing: commands, hotkeys, autocomplete
• New File Now: create new files from the command palette
• Notebox: take quick notes in the bottom panel
• Todo Tomorrow: highlight TODO, HACK, FIXME, etc. comments
• Reveal in Ghostty: reveal current project or folder in Ghostty
• Reveal in Nimble Commander: reveal current project or folder in Nimble Commander
• Squirrelsong Light Theme: low contrast non-distracting light theme for web developers
• Squirrelsong Dark Theme: low contrast non-distracting dark theme for web developers

Sponsoring

This software has been developed with lots of coffee, buy me one more cup to keep it going.

Contributing

Bug fixes are welcome, but not new features. Please take a moment to review the contributing guidelines.

Authors and license

Artem Sapegin, and contributors.

MIT License, see the included License.md file.