Document hl groups in README

Author: dangooddd

README.md

@@ -82,11 +82,13 @@ https://github.com/user-attachments/assets/19822d92-5173-4441-8cec-6a59f9eb41b9
 This plugin aims to provide a sensible workflow to work with Python REPL.
 
 Main goals of this project:
+
 - Ability to send code from buffer to REPL;
 - Ability to display images in Neovim directly;
 - Balance code complexity with sensible features for a REPL workflow.
 
 What features `pyrepl.nvim` currently provides:
+
 - Convert notebook files from and to python with `jupytext`;
 - Install all runtime deps required with a command (no need to install kernel globally with default settings);
 - Use `jupyter-console` TUI for the REPL;
@@ -210,6 +212,12 @@ Commands:
 - `:PyreplConvert` - prompt to convert current notebook buffer to python (`jupytext` should be installed);
 - `:PyreplInstall {tool}` - install pyrepl runtime packages into the configured Python (`tool`: `pip` or `uv`).
 
+Highlight groups:
+
+- `PyreplImageBorder` (link to `FloatBorder` by default);
+- `PyreplImageTitle` (link to `FloatTitle` by default);
+- `PyreplImageNormal` (link to `NormalFloat` by default).
+
 Lua API:
 
 ```lua

doc/pyrepl.txt

@@ -377,16 +377,9 @@ While focused in the image window:
 HIGHLIGHTS                                                     *pyrepl-highlights*
 
 pyrepl.nvim defines these highlight groups:
-  PyreplImageBorder
-  PyreplImageTitle
-  PyreplImageNormal
-
-Default links:
->
-  vim.api.nvim_set_hl(0, "PyreplImageBorder", { link = "FloatBorder" })
-  vim.api.nvim_set_hl(0, "PyreplImageTitle", { link = "FloatTitle" })
-  vim.api.nvim_set_hl(0, "PyreplImageNormal", { link = "NormalFloat" })
-<
+  `PyreplImageBorder` (link to |FloatBorder| by default)
+  `PyreplImageTitle` (link to |FloatTitle| by default)
+  `PyreplImageNormal` (link to |NormalFloat| by default)
 
 ==============================================================================
 TROUBLESHOOTING                                                *pyrepl-troubleshooting*

lua/pyrepl/image.lua

@@ -47,7 +47,7 @@ local function open_image_win(buf)
     local normal_hl = "PyreplImageNormal"
 
     if vim.tbl_isempty(vim.api.nvim_get_hl(0, { name = border_hl })) then
-        vim.api.nvim_set_hl(0, border_hl, { link = "Special" })
+        vim.api.nvim_set_hl(0, border_hl, { link = "FloatBorder" })
     end
 
     if vim.tbl_isempty(vim.api.nvim_get_hl(0, { name = title_hl })) then