tpope / vim-surround
git clone https://github.com/tpope/vim-surround.git
🔥 on GitHub Trending today
surround.vim: Delete/change/add parentheses/quotes/XML-tags/much more with ease
+0
stars, 24h · #15,559
+~0
stars, 7 days · #16,041
+15
stars, 30 days · #22,170
14k
★ total
448
forks · 115 open issues
Star history (as recorded here)
LanguageVim Script
License—
Created2008-09-11 (18y ago)
Last push2y ago
Watchers127
OwnerUser
Seen on GitHub Trending
- 2026-10-22 — #7 monthly in vim-script · +14 ★
- 2026-10-21 — #8 monthly in vim-script · +14 ★
- 2026-10-20 — #8 monthly in vim-script · +15 ★
Links
- GitHub: github.com/tpope/vim-surround
- Homepage: https://www.vim.org/scripts/script.php?script_id=1697
- Releases · Issues · Hacker News mentions
README excerpt
# surround.vim
Surround.vim is all about "surroundings": parentheses, brackets, quotes,
XML tags, and more. The plugin provides mappings to easily delete,
change and add such surroundings in pairs.
It's easiest to explain with examples. Press `cs"'` inside
"Hello world!"
to change it to
'Hello world!'
Now press `cs' ` to change it to
Hello world!
To go full circle, press `cst"` to get
"Hello world!"
To remove the delimiters entirely, press `ds"`.
Hello world!
Now with the cursor on "Hello", press `ysiw]` (`iw` is a text object).
[Hello] world!
Let's make that braces and add some space (use `}` instead of `{` for no
space): `cs]{`
{ Hello } world!
Now wrap the entire line in parentheses with `yssb` or `yss)`.
({ Hello } world!)
Revert to the original text: `ds{ds)`
Hello world!
Emphasize hello: `ysiw `
Hello world!
Finally, let's try out visual mode. Press a capital V (for linewise
visual mode) followed by `S `.
Hello world!
This plugin is very powerful for HTML and XML editing, a niche which
currently seems underfilled in Vim land. (As opposed to HTML/XML
*inserting*, for which many plugins are available). Adding, changing,
and removing pairs of tags simultaneously is a breeze.
The `.` command will work with `ds`, `cs`, and `yss` if you install
repeat.vim.
## Installation
Install using your favorite package manager, or use Vim's built-in package
support:
mkdir -p ~/.vim/pack/tpope/start
cd ~/.vim/pack/tpope/start
git clone https://tpope.io/vim/surround.git
vim -u NONE -c "helptags surround/doc" -c q
## FAQ
> How do I surround without adding a space?
Only the opening brackets—``, `{`, and `(`—add a space. Use a closing
bracket, or the `b` (`(`) and `B` (`{`) aliases.
## Contributing
See the contribution guidelines for
[pathogen.vim.
## Self-Promotion
Like surround.vim? Star the repository on
GitHub and vote for it on
vim.org.
Love surround.vim? Follow tpope on
GitHub and
Twitter.
## License
Copyright (c) Tim Pope. Distributed under the same terms as Vim itself.
See `:help license`.