sponsor Vim development Vim logo Vim Book Ad

match-up : even better %, navigate & highlight matching word, modern matchit replacement

 script karma  Rating 47/20, Downloaded by 2364  Comments, bugs, improvements  Vim wiki

created by
andy massimino
script type
The current version of this plugin is always available from:


match-up is a plugin that lets you visualize, navigate, and operate on
sets of matching text.  The plugin:

- Extends vim's % motion to language-specific words instead of just single
  characters.  The words depend on the specific filetype plugin.  The
  following built-in vim filetype plugins currently provide support for

    abaqus, ada, aspvbs, c, clojure, cobol, config, context, csc, csh, dtd,
    dtrace, eiffel, eruby, falcon, fortran, framescript, haml, hamster, hog,
    html, ishd, j, jsp, kconfig, liquid, lua, make, matlab, mf, mp, ocaml,
    pascal, pdf, perl, php, plaintex, postscr, ruby, sh, spec, sql, tex, vb,
    verilog, vhdl, vim, xhtml, xml, zimbu, zsh

- Highlights symbols and words under the cursor along with their matches.

- Displays off-screen matches in the status-line.

- Adds motions g%, [%, ]%, and z%.

- Provides analogous text objects i% and a%.

match-up is a replacement for the venerable vim plugin matchit.  match-up
replicates all of matchit's features, fixes a number of its deficiencies
and bugs, and adds a few totally new features.  It also replaces the
standard plugin matchparen, allowing all of matchit's words to be
highlighted along with the 'matchpairs' symbols such as (), {}, and [].
install details
The preferred method of installation is to use vim-plug or another plugin
manager to ensure you always have the most up-to-date version of match-up.

    Plug 'andymass/vim-matchup'

Alternatively, download and extract the package and install manually using any
standard vim way.

rate this script Life Changing Helpful Unfulfilling 
script versions (upload new version)

Click on the package to download.

package script version date Vim version user release notes
vim-matchup-0.7.0.zip 0.7.0 2022-01-01 7.4 andy massimino Improved the off-screen popup window, including adding extended highlighting.  Made miscellaneous bug fixes.
vim-matchup-0.6.0.zip 0.6.0 2021-02-23 7.4 andy massimino Adds "same character" matching (currently for tex and javascript). Miscellaneous fixes.
vim-matchup-0.5.0.zip 0.5.0 2020-05-08 7.4 andy massimino Use popup window to show off-screen matches.  Improve matching with lua and ruby.  Add :MatchupWhereAmI? to show breadcrumb-style location in code.  Fix miscellaneous bugs in motions and text-objects.
vim-matchup-0.4.0.zip 0.4.0 2019-03-08 7.4 andy massimino Add off-screen line adjustment for C-like languages.  Add match highlight fading feature.  Fix many bugs.
Note: now distributed on vim scripts as a flat archive.
vim-matchup-0.3.0.zip 0.3 2018-11-16 7.4 andy massimino Add html highlighting of tag only. Add surround and highlight background features. Fix many bugs.
vim-matchup-0.2.0.zip 0.2 2018-03-06 7.4 andy massimino Numerous improvements have been made including better support for LaTeX.
match-up.zip 0.1 2017-11-30 7.4 andy massimino Initial upload
ip used for rating:

If you have questions or remarks about this site, visit the vimonline development pages. Please use this site responsibly.
Questions about Vim should go to the maillist. Help Bram help Uganda.
Vim at Github