fix(readme): update highlight instructions

1 files changed, 13 insertions, 8 deletions

diff --git a/README.md b/README.md
index 3b0bda0ea..28ffd55a3 100644
--- a/README.md
+++ b/README.md
@@ -331,17 +331,22 @@ require'nvim-treesitter.configs'.setup {
 }
 ```
 
-You can add custom highlight captures with:
+To customize the syntax highlighting of a capture, simply define or link a highlight group of the same name:
 
-```vim
-lua <<EOF
-  require"nvim-treesitter.highlight".set_custom_captures {
-    -- Highlight the @foo.bar capture group with the "Identifier" highlight group.
-    ["foo.bar"] = "Identifier",
-  }
-EOF
+```lua
+-- Highlight the @foo.bar capture group with the "Identifier" highlight group
+vim.api.nvim_set_hl(0, "@foo.bar", { link = "Identifier" })
+```
+
+For a language-specific highlight, append the name of the language:
+
+```lua
+-- Highlight @foo.bar as "Identifier" only in Lua files
+vim.api.nvim_set_hl(0, "@foo.bar.lua", { link = "Identifier" })
 ```
 
+See `:h treesitter-highlight-groups` for details.
+
 #### Incremental selection
 
 Incremental selection based on the named nodes from the grammar.