Joining lines in Vim streamlines text editing by turning scattered lines into a single, clean block. This technique reduces repetitive hand movements and keeps your focus on content rather than navigation.
Whether you are cleaning up logs, formatting code, or preparing documentation, the join lines workflow integrates smoothly with normal mode motions and repeatable operators. The summary below highlights the primary behaviors and variations you will encounter most often.
| Operator | Key Sequence | Scope | Behavior |
|---|---|---|---|
| join | J | Current line | Merges the line below into the current line with a single space |
| join with custom separator | gJ | Current line | Merges lines without inserting a space, preserving existing whitespace |
| join with formatting | gJ^] | Current paragraph | Removes blank lines and respects paragraph formatting rules |
| join count | 3J | Current + next N lines | Merges multiple lines in one step, using a single space between segments |
| visual line join | VJ | Selected lines | Joins only the lines covered by the visual selection |
Basic join commands for everyday edits
In normal mode, the core join command works on the current line and the line directly below it. You can repeat the action with the dot operator or drive it with a count to merge several lines at once.
Advanced users often combine join with motions and text objects. For example, pairing it with paragraph movements lets you reformat blocks of text while maintaining consistent spacing rules dictated by your configuration.
Whitespace handling and visual line selection
By default, Vim inserts a single space when joining lines, which can affect alignment in tightly formatted files. Understanding how whitespace is managed helps you avoid unintended changes in columnar data or source code.
Using visual mode before pressing J applies the join only to the selected lines. This precision is especially helpful when you need to merge specific segments without altering the rest of the buffer.
Customizing join behavior with options
Vim provides options that control how lines are combined, including the type of separator used and how paragraph boundaries are respected. Tweaking these settings can make the join behavior match your preferred editing style.
Script authors and power users often adjust these options to integrate joining seamlessly into larger automated workflows, ensuring predictable results across diverse file types.
Practical tips for reliable line joining
- Remember that J is a normal mode operator that merges the current line with the next one.
- Use gJ when you need to concatenate lines without introducing extra spaces.
- Combine counts with J to merge multiple lines efficiently in one step.
- Leverage visual mode when you want to restrict joining to a specific block of text.
- Review your 'joinspaces' and 'formatoptions' settings to align default behavior with your formatting preferences.
FAQ
Reader questions
How do I join two lines without adding an extra space?
Use gJ in normal mode to join the current line with the next line while preserving existing whitespace and omitting any inserted space.
Can I join more than two lines at once in Vim?
Yes, specify a count before J, such as 3J, to merge the current line with the next two lines in a single operation.
What happens when I use join on a blank line?
Joining across a blank line typically removes that blank line and continues the merge, depending on your paragraph and join settings.
How can I join lines inside a visual selection only?
Enter Visual Line mode with V, select the target lines, then press J to join only the chosen segment.