Beautiful quickfix and location list formatting with diagnostic and LSP kind icons.

• Neovim 0.10+
• Nerd Font for icon rendering

Install via your preferred plugin manager. The following example uses lazy.nvim.

{
  'wassimk/qf-formatter.nvim',
  event = 'VeryLazy',
  opts = {}
}

• Formatted quickfix and location list entries: filename │line:col│ [icon] text
• Truncates long filenames with ellipsis
• Replaces $HOME with ~ in file paths
• Diagnostic icons for error, warning, info, and hint entries
• LSP kind icons (codicons) for document symbol entries
• Syntax highlighting for filenames, separators, line numbers, diagnostics, and LSP kinds

The setup() function accepts an options table. All values are optional.

require('qf-formatter').setup({
  filename_width = 32, -- max filename column width (default: 32)
})

All highlights are defined with default = true, so your colorscheme always takes priority. Every group is prefixed with QfFormatter so you can customize the quickfix appearance without affecting the rest of Neovim.

Quickfix structure:

Diagnostic icons:

LSP kind icons:

To customize any group, override it in your config:

vim.api.nvim_set_hl(0, 'QfFormatterFilename', { fg = '#82aaff' })
vim.api.nvim_set_hl(0, 'QfFormatterKindMethod', { link = 'BlinkCmpKindMethod' })

Run tests and lint:

make test
make lint

Enable the local git hooks (one-time setup):

git config core.hooksPath .githooks

This activates a pre-commit hook that auto-generates doc/qf-formatter.nvim.txt from README.md whenever the README is staged. Requires pandoc.